次の方法で共有

CreateRemoteThreadEx 関数 (processthreadsapi.h)

  • [アーティクル]

別のプロセスの仮想アドレス空間で実行され、必要に応じてプロセッサ グループアフィニティなどの拡張属性を指定するスレッドを作成します。

構文

HANDLE CreateRemoteThreadEx(
  [in]            HANDLE                       hProcess,
  [in, optional]  LPSECURITY_ATTRIBUTES        lpThreadAttributes,
  [in]            SIZE_T                       dwStackSize,
  [in]            LPTHREAD_START_ROUTINE       lpStartAddress,
  [in, optional]  LPVOID                       lpParameter,
  [in]            DWORD                        dwCreationFlags,
  [in, optional]  LPPROC_THREAD_ATTRIBUTE_LIST lpAttributeList,
  [out, optional] LPDWORD                      lpThreadId
);

パラメーター

[in] hProcess

スレッドが作成されるプロセスのハンドル。 ハンドルには、PROCESS_CREATE_THREAD、PROCESS_QUERY_INFORMATION、PROCESS_VM_OPERATION、PROCESS_VM_WRITE、およびPROCESS_VM_READアクセス権が必要です。 Windows 10 バージョン 1607 では、コードは新しいハンドルに対してこれらのアクセス権を取得する必要があります。 ただし、Windows 10 バージョン 1703 以降では、新しいハンドルにこれらのアクセス権が付与されている場合は、システムによって取得されます。 詳細については、「プロセス セキュリティとアクセス権の」を参照してください。

[in, optional] lpThreadAttributes

新しいスレッドのセキュリティ記述子を指定し、子プロセスが返されたハンドルを継承できるかどうかを判断する SECURITY_ATTRIBUTES 構造体へのポインター。 lpThreadAttributes が NULL の場合、スレッドは既定のセキュリティ記述子を取得し、ハンドルを継承できません。 スレッドの既定のセキュリティ記述子のアクセス制御リスト (ACL) は、作成者のプライマリ トークンから取得されます。

[in] dwStackSize

スタックの初期サイズ (バイト単位)。 システムは、この値を最も近いページに丸めます。 このパラメーターが 0 (ゼロ) の場合、新しいスレッドは実行可能ファイルの既定のサイズを使用します。 詳細については、「スレッド スタック サイズのを する」を参照してください。

[in] lpStartAddress

型のアプリケーション定義関数へのポインター LPTHREAD_START_ROUTINE スレッドによって実行され、リモート プロセス内のスレッドの開始アドレスを表します。 関数はリモート プロセスに存在する必要があります。 詳細については、ThreadProcを参照してください。

[in, optional] lpParameter

lpStartAddressが指すスレッド関数 渡される変数へのポインター。 このパラメーターには NULL を指定できます。

[in] dwCreationFlags

スレッドの作成を制御するフラグ。

価値 意味
0
 スレッドは作成直後に実行されます。
CREATE_SUSPENDED
0x00000004
 スレッドは中断状態で作成され、ResumeThread 関数が呼び出されるまで実行されません。
STACK_SIZE_PARAM_IS_A_RESERVATION
0x00010000
 dwStackSize パラメーターは、スタックの初期予約サイズを指定します。 このフラグを指定しない場合は、dwStackSize コミット サイズを指定します。

[in, optional] lpAttributeList

新しいスレッドの追加パラメーターを含む属性リスト。 このリストは、InitializeProcThreadAttributeList 関数によって作成されます。

[out, optional] lpThreadId

スレッド識別子を受け取る変数へのポインター。

このパラメーターが NULL の場合、スレッド識別子は返されません。

戻り値

関数が成功した場合、戻り値は新しいスレッドへのハンドルです。

関数が失敗した場合、戻り値は NULL です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

CreateRemoteThreadEx 関数により、指定されたプロセスのアドレス空間で新しい実行スレッドが開始されます。 スレッドは、プロセスが開くすべてのオブジェクトにアクセスできます。 lpAttribute パラメーターを使用して、新しいスレッドのプロセッサ グループ アフィニティなどの拡張属性を指定できます。 lpAttribute NULL の場合、関数の動作は CreateRemoteThreadと同じです。

Windows 8 より前のターミナル サービスでは、各ターミナル セッションが設計によって分離されています。 そのため、ターゲット プロセスが呼び出し元プロセスとは異なるセッションにある場合、CreateRemoteThread は失敗します。

新しいスレッド ハンドルは、新しいスレッドへのフル アクセスで作成されます。 セキュリティ記述子が指定されていない場合は、スレッド オブジェクト ハンドルを必要とする任意の関数でハンドルを使用できます。 セキュリティ記述子を指定すると、アクセスが許可される前に、以降のすべてのハンドルの使用に対してアクセス チェックが実行されます。 アクセス チェックでアクセスが拒否された場合、要求プロセスはハンドルを使用してスレッドにアクセスすることはできません。

スレッドが実行可能な状態で作成された場合 (つまり、CREATE_SUSPENDED フラグが使用されていない場合)、CreateThread が返される前、特に呼び出し元が作成されたスレッドのハンドルと識別子を受け取る前に、スレッドの実行を開始できます。

スレッドは、スレッドの優先順位が THREAD_PRIORITY_NORMAL で作成されます。 スレッドの優先度の値を取得して設定するには、GetThreadPriority を使用し、SetThreadPriority 関数 します。

スレッドが終了すると、スレッド オブジェクトはシグナル状態を取得し、オブジェクトを待機しているスレッドを満たします。

スレッド オブジェクトは、スレッドが終了し、それに対するすべてのハンドルが CloseHandleの呼び出しによって閉じられるまで、システム 残ります。

ExitProcess、ExitThread、createThread、CreateRemoteThread 関数、および開始中のプロセス (CreateProcess 呼び出しの結果) は、プロセス内で相互にシリアル化されます。 アドレス空間で一度に発生するイベントは 1 つだけです。 つまり、次の制限が保持されます。

  • プロセスの起動および DLL 初期化ルーチン中に、新しいスレッドを作成できますが、プロセスに対して DLL の初期化が行われるまで実行は開始されません。
  • プロセス内のスレッドは、一度に 1 つの DLL 初期化またはデタッチ ルーチンに含めることができます。
  • ExitProcess は、すべてのスレッドが DLL の初期化またはデタッチ ルーチンを完了した後に返されます。
この関数の一般的な用途は、中断を発行するためにデバッグ中のプロセスにスレッドを挿入することです。 ただし、この使用は推奨されません。これは、追加のスレッドがアプリケーションをデバッグしているユーザーに混乱を招き、この手法を使用する場合にいくつかの副作用があるためです。
  • シングル スレッド アプリケーションをマルチスレッド アプリケーションに変換します。
  • プロセスのタイミングとメモリのレイアウトが変更されます。
  • その結果、プロセス内の各 DLL のエントリ ポイントが呼び出されます。
この関数のもう 1 つの一般的な用途は、スレッドをプロセスに挿入して、ヒープまたはその他のプロセス情報を照会することです。 これにより、前の段落で説明したのと同じ副作用が発生する可能性があります。 また、スレッドが別のスレッドが使用しているロックの所有権を取得しようとすると、アプリケーションがデッドロックする可能性があります。

必要条件

要件 価値
サポートされる最小クライアント Windows 7 [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー processthreadsapi.h (Windows Server 2008 Windows Server 2008 R2 の Windows.h を含む)
ライブラリ Kernel32.lib
DLL Kernel32.dll

関連項目

CreateRemoteThread の