次の方法で共有

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 で使用できます。 LoadLibrary 関数と GetProcAddress 関数を使用して、Ntdll.dllに動的にリンクすることもできます。

必要条件

要件 値
[DLL]
Ntdll.dll