CloseHandle: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
K
Zeile 1: Zeile 1:
Diese Funktion ''schließt'' eine Datei oder einen Datenkanal. Kanäle können ein COM- oder LPT-Port, ein Gerät, ein Dienst oder eine Console sein.  
+
Diese Funktion ''schließt'' eine Datei oder einen Datenkanal. Kanäle können zu einem COM- oder LPT-Port, ein Gerät, einem Dienst oder einer Console geöffnet worden sein.  
  
 
<PRE>
 
<PRE>
Zeile 15: Zeile 15:
 
'''Rückgabe'''
 
'''Rückgabe'''
  
Ist die Funktion erfolgreich, so erfolgt eine Übergabe des wertes "1".  
+
War die Funktion erfolgreich, so erfolgt eine Übergabe des wertes True = 1.  
Sollte die Funktion fehlschlage, so kann per ''GetLastError'' die Fehlerursache festgestellt werden.
+
Sollte die Funktion fehlschlagen, so kann die Fehlerursache per ''GetLastError'' festgestellt werden.
  
  

Version vom 26. Februar 2007, 15:10 Uhr

Diese Funktion schließt eine Datei oder einen Datenkanal. Kanäle können zu einem COM- oder LPT-Port, ein Gerät, einem Dienst oder einer Console geöffnet worden sein.

Declare Function CloseHandle Lib "kernel32" Alias "CloseHandle" ( _
                             ByVal hObject As Long) As Long

Übergabe

hObject

hObjekt erwartet ein gültiges Dateihandle zur Übergabe.


Rückgabe

War die Funktion erfolgreich, so erfolgt eine Übergabe des wertes True = 1. Sollte die Funktion fehlschlagen, so kann die Fehlerursache per GetLastError festgestellt werden.


Beispiel

    Dim CloseResult as Long

    CloseResult = CloseHandle(FileHandle)
    
    If CloseResult <> 1 Then
        MsgBox "Fehler beim Schließen des Objektes!", vbCritical, "Fehler!"
    End If