共用方式為


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

另請參閱

CloseHandle

GetExitCodeThread

GetThreadContext

處理序和執行緒函式

ResumeThread

SetThreadContext

SetTokenInformation

SuspendThread

TerminateThread

執行緒