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 |