CloseHandle

Функция CloseHandle закрывает дескриптор открытого объекта.

BOOL CloseHandle(
    HANDLE hObject  // дескриптор закрываемого объекта
);

Параметры:

hObject

Определяет дескриптор открытого объекта.

Возвращаемые значения:

При успешном завершении, функция возвращает ненулевое значение.

При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызовите GetLastError.

Замечания:

Функция CloseHandle закрыает дескрипторы следующих объектов:

• Ввод и вывод консоли
• Файл события
• Мютексы
• Файл планирования
• Процесс
• Семафор
• Поток
• Маркер (только в системах Windows NT)

CloseHandle делает недействительным указанный дескриптор объекта, декрементируя число дескрипторов объекта, и выполняет проверку удерживания объекта. Когда последний объект будет закрыт, объект удаляется из операционной системы.

Эта функция не закрывает объекты модулей.

Используйте CloseHandle для закрытия дескрипторов, возвращенных при вызове функции CreateFile. Используйте функцию FindClose для закрытия дескрипторов, возвращенных функцией FindFirstFile.

Закрытие неверного дескриптора приведет к исключению.

Смотрите также:

CreateFile, DeleteFile, FindClose, FindFirstFile