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