CloseHandle

CloseHandle closes an open object handle.

Syntax

BOOL CloseHandle(
    HANDLE hObject
);

Parameters

hObject

An open object handle.

Return Value

TRUE if the function succeeds, FALSE if the function fails

To get extended error information, call GetLastError.

Remarks

CloseHandle closes handles to thread and file objects. It invalidates the specified object handle, decrements the object's handle count, and performs object-retention checks. Once the last handle to an object is closed, the object is removed from the operating system.

NOTE: In the RTSS environment, CloseHandle can also be used to close any RTX object. Use the RtCloseHandle to close RTSS objects. In the Windows environment, CloseHandle can only close Win objects.

See Also:

RtCloseHandle