CloseHandle

小甲鱼

注：本文档由 谁动了我的豆包 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

CloseHandle 函数用于关闭一个打开的对象的句柄。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI CloseHandle(
  _In_ HANDLE hObject
);

参数解析：

参数	含义
hObject	该参数指定一个打开的对象的有效句柄

返回值：

1. 如果函数运行成功，则返回值为非 0；

2. 如果函数运行失败，则返回值为 0。

想要调用更多的错误信息，请调用 GetLastError 函数。

当应用正在一个调试器下运行时，如果函数接收到了无效的句柄值或者伪句柄值中的任何一个，该函数将抛出异常。如果你关闭一个句柄两次，或者如果你在通过 FindFirstFile 函数返回的句柄上调用 CloseHandle 函数来代替调用 FindClose 函数这种情况就会发生。


备注：

1. CloseHandle 函数关闭下列对象的句柄：

• Access token
• Communications device
• Console input
• Console screen buffer
• Event
• File
• File mapping
• I/O completion port
• Job
• Mailslot
• Memory resource notification
• Mutex
• Named pipe
• Pipe
• Process
• Semaphore
• Thread
• Transaction
• Waitable timer
  

2. 创建这些对象的函数的文档表明，当你完成了该对象时，CloseHandle 函数应该被调用，也能表明在该句柄被关闭后，对象的挂起操作中发生了什么。通常，CloseHandle 函数使指定的对象句柄无效，递减该对象的句柄数并执行对象的保留检查。当一个对象的最后一个句柄被关闭后，该对象会从系统中被撤销。对于这些对象的创建者函数的摘要，请参照 Kernel Objects。

3. 通常，当一个应用打开时，它应该为每一个句柄调用一次 CloseHandle 函数。如果一个使用了一个句柄的函数带有 ERROR_INVALID_HANDLE 标识的失败，那么调用 ClsoeHandle 函数就没有必要了，因为这个错误通常表明该句柄已经无效了。然而，一些函数用 ERROR_INVALID_HANDLE 来表明该对象自己不再有效。例如，如果网络被切断，那么一个尝试对网络上的一个文件使用一个句柄的函数可能就会出现带有 ERROR_INVALID_HANDLE 标识的失败，因为文件对象已经不可用了。在这种情况下，应用应该关闭句柄。如果一个句柄要被处理，那么对于一个事务的全部句柄绑定都要在事务被提交之前被关闭。如果一个被处理的句柄通过调用带有 FILE_FLAG_DELETE_ON_CLOSE 标识的 CreatFileTransacted 函数被打开，该文件不会被删除，直到应用关闭该句柄并且调用了 CommitTransaction 函数。更多关于被处理的对象的信息，请参照 working With Transactions。

4. 关闭一个线程句柄不终止与该句柄有关联的线程，也不会撤销该线程的对象。关闭一个进程句柄不终止与该句柄有关联的线程，也不会撤销该进程的对象。想要撤销一个线程的对象，你必须终止该线程，然后关闭该线程的全部句柄。更多信息，请参照 Terminating a Thread。想要撤销一个进程的对象，你必须终止该进程，然后关闭该进程的全部句柄。更多信息，请参照 Terminating a Process。

5. 即使有文件试图仍然打开时，也能成功关闭一个文件映像的句柄。更多信息请参照 Closing a File Mapping Object。

6. 不要用 CloseHandle 函数去关闭一个套接字。而是要使用 closesocket 函数。该函数可以释放与套接字有关联的全部资源，包括套接字对象的句柄。更多信息，请参照 Socket Closure。

7. 不要使用 CloseHandle 函数去关闭一个打开的注册表项的句柄。而是要用 RegCloseKey 函数。CloseHandle 函数不会关闭注册表项的句柄，但也不会返回一个错误来指明关闭失败了。


需求：

Minimum supported client	Windows 2000 专业版 [桌面应用程序 | Windows 商店应用程序]
Minimum supported server	Windows 2000 服务器版 [桌面应用程序 | Windows 商店应用程序]
Minimum supported phone	Windows Phone 8
Header	Winbase.h (包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。