OpenThread 函式 (processthreadsapi.h)
開啟現有的線程物件。
語法
HANDLE OpenThread(
[in] DWORD dwDesiredAccess,
[in] BOOL bInheritHandle,
[in] DWORD dwThreadId
);
參數
[in] dwDesiredAccess
線程物件的存取權。 系統會針對線程的安全性描述項檢查此訪問許可權。 此參數可以是一或多個 線程訪問許可權。
如果呼叫端已啟用 SeDebugPrivilege 許可權,則不論安全性描述元的內容為何,都會授與要求的存取權。
[in] bInheritHandle
如果此值為TRUE,此進程所建立的進程將會繼承句柄。 否則,進程不會繼承此句柄。
[in] dwThreadId
要開啟之線程的標識碼。
傳回值
如果函式成功,則傳回值是指定線程的開啟句柄。
如果函式失敗,傳回值為NULL。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
OpenThread 傳回的句柄可用於任何需要線程句柄的函式,例如等候函式,前提是您要求適當的訪問許可權。 只有 dwDesiredAccess 參數中指定的範圍,才會將句柄的存取權授與線程物件。
當您完成句柄時,請務必使用 CloseHandle 函式加以關閉。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | processthreadsapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |