На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

CloseHandle



The CloseHandle function closes an open object handle.

BOOL CloseHandle(

HANDLE hObject // handle to object to close
);


Parameters

hObject

Identifies an open object handle.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The CloseHandle function closes handles to the following objects:

· Console input or output
· Event file
· File mapping
· Mutex
· Named pipe
· Process
· Semaphore
· Thread
· Token (Windows NT only)



CloseHandle 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.
This function does not close module objects.
Use CloseHandle to close handles returned by calls to the CreateFile function. Use FindClose to close handles returned by calls to the FindFirstFile function.
Closing an invalid handle raises an exception. This includes closing a handle twice, not checking the return value and closing an invalid handle, and using CloseHandle on a handle returned by FindFirstFile.

See Also

CreateFile, DeleteFile, FindClose, FindFirstFile


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

CloseHandle



Функция CloseHandle закрывает открытую объектную ручку.

BOOL CloseHandle(

РУЧКА РУЧКИ hObject //, чтобы возражать против закрытия
);


Параметры

hObject

Идентифицирует открытую объектную ручку.



Обратные Величины

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

Замечания

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

Ввод Консоли или выход файл События Файл, отображающий Mutex Назвавшее трубу Процесс Семафор Резьба
Признак (Windows NT только)



CloseHandle АННУЛИРУЕТ определенную объектную ручку, декременты объектный счет ручки и выполняет объектные чеки членства. Как только последняя ручка на объект будет закрыта, объект удален из операционной системы.
Эта функция не закрывает модульные объекты.
Используйте CloseHandle, чтобы закрывать ручки возвращанные вызовами в функцию CreateFile. Используйте FindClose, чтобы закрывать ручки возвращанные вызовами в функцию FindFirstFile.
Закрытие неправильной ручки поднимает исключение. Это включает закрывая ручку дважды, не проверяя обратную величину и закрывая неправильную ручку, и используя CloseHandle в ручке возвращанной FindFirstFile.

Смотри Также

CreateFile, DeleteFile, FindClose, FindFirstFile


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz