CloseHandle

Aus API-Wiki
Wechseln zu: Navigation, Suche

Diese Funktion schließt ein Kernelobjekthandle, z.B. 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.

' VB 5/6
Declare Function CloseHandle Lib "kernel32.dll" ( _
                             ByVal hObject As Long) As Long
' VB.NET
<DllImport("kernel32.dll", SetLastError:=True)> _
Public Shared Function CloseHandle(ByVal hObject As IntPtr) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

Übergabe

hObject

hObject erwartet ein gültiges Kernelobjekthandle als Übergabe (z.B. von CreateFile).


Rückgabe

War die Funktion erfolgreich, so erfolgt eine Übergabe eines Wertes ungleich 0. Sollte die Funktion fehlschlagen, so kann die Fehlerursache mittels Err.LastDLLError festgestellt werden.


Beispiel

    Dim CloseResult as Long

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