共用方式為


NtOpenThread 函式

[此函式可能會從 Windows 變更或移除,而不需進一步通知。 請改用 OpenThread 函式。]

開啟具有指定存取權之執行緒物件的控制碼。

語法

NTSTATUS NtOpenThread(
  _Out_ PHANDLE            ThreadHandle,
  _In_  ACCESS_MASK        DesiredAccess,
  _In_  POBJECT_ATTRIBUTES ObjectAttributes,
  _In_  PCLIENT_ID         ClientId
);

參數

ThreadHandle [out]

接收執行緒物件控制碼之變數的指標。

DesiredAccess [in]

提供執行緒物件所需存取類型的 ACCESS_MASK 資料類型。

ObjectAttributes [in]

OBJECT_ATTRIBUTES結構的指標。 這個結構的 ObjectName 成員必須是 Null。

Windows Server 2003 和 Windows XP: 這個結構的 ObjectName 成員可以指向物件名稱。 如果 ObjectName 不是 Null, ClientId 參數必須是 Null。

ClientId [in]

CLIENT_ID結構的指標,可識別要開啟其執行緒的執行緒。

Windows Server 2003 和 Windows XP:CLIENT_ID結構的指標,可識別要開啟其執行緒的執行緒。 此參數可以是 Null。 如果此參數不是 Null,ObjectAttributes參數所指向之結構的ObjectName成員必須是 Null。

傳回值

傳回 NTSTATUS 或錯誤碼。

NTSTATUS錯誤碼的格式和重要性會列在 WDK 中提供的 Ntstatus.h 標頭檔中,並說明于 WDK 檔中。

備註

此函式沒有相關聯的標頭檔。 相關聯的匯入程式庫 Ntdll.lib 可在 WDK 中使用。 您也可以使用 LoadLibraryGetProcAddress 函式,動態連結至Ntdll.dll。

規格需求

需求
DLL
Ntdll.dll