GetProcessHandleCount 函式 (processthreadsapi.h)

擷取屬於指定進程的開啟句柄數目。

語法

BOOL GetProcessHandleCount(
  [in]      HANDLE hProcess,
  [in, out] PDWORD pdwHandleCount
);

[in] hProcess

正在要求其句柄計數的進程句柄。句柄必須具有PROCESS_QUERY_INFORMATION或PROCESS_QUERY_LIMITED_INFORMATION訪問許可權。如需詳細資訊，請參閱處理安全性和訪問許可權。

Windows Server 2003 和 Windows XP： 句柄必須具有PROCESS_QUERY_INFORMATION訪問許可權。

[in, out] pdwHandleCount

變數的指標，接收屬於指定進程的開啟句柄數目。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

此函式會擷取程式之執行對象的相關信息。如需詳細資訊，請參閱核心物件。

若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0501或更新版本。如需詳細資訊，請參閱使用 Windows 標頭。

需求	值
最低支援的用戶端	Windows Vista、Windows XP SP1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	processthreadsapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
程式庫	Kernel32.lib
DLL	Kernel32.dll