Реферат - Потоки / Функция CloseHandle

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

Синтаксис BOOL CloseHandle( HANDLE hObject // дескриптор объекта );Параметры hObject

[in/out] Дескриптор открытого объекта.

Возвращаемые значения Если функция завершается успешно, величина возвращаемого значения - не ноль.

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

Windows NT /2000/XP: Закрытие ошибочного дескриптора порождает исключительную ситуацию, когда приложение выполняется в среде отладчика. Это включает в себя закрытие дескриптора дважды и использование функции CloseHandle для дескриптора, возвращенного функцией FindFirstFile.

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

Признак доступа

Устройство связи

Консольный ввод данных

Экранный буфер консоли

Событие

Файл

Файл, отображаемый в память

Задание

Почтовый ящик в ядре системы

Мьютекс

Именованный канал

Процесс

Семафор

Сокет

Поток 

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

Закрытие дескриптора потока не завершает работу связанного потока. Чтобы удалить объект потока, Вы должны завершить работу потока, затем закрыть все дескрипторы потока.

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

Код примера Пример смотрите в статье Очистка.

Смотри также Обзор Дескрипторы и объекты, Функции дескрипторов и объектов, CreateFile, DeleteFile, FindClose, FindFirstFile

Размещение и совместимость CloseHandle

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

  - объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

Назад в оглавление На главную страницу На оглавление справки 13.08.2003 22:26 ©Copyright V. Sokovikov #bn { DISPLAY: block } #bt { DISPLAY: block }