GetThreadInformation 関数 (processthreadsapi.h)

指定したスレッドに関する情報を取得します。

構文

BOOL GetThreadInformation(
  [in] HANDLE                   hThread,
  [in] THREAD_INFORMATION_CLASS ThreadInformationClass,
       LPVOID                   ThreadInformation,
  [in] DWORD                    ThreadInformationSize
);

パラメーター

[in] hThread

スレッドへのハンドル。 ハンドルにはTHREAD_QUERY_INFORMATIONアクセス権が必要です。 詳細については、「 スレッド セキュリティとアクセス権」を参照してください。

[in] ThreadInformationClass

取得する情報のクラス。 この値には、 ThreadMemoryPriority、 ThreadAbsoluteCpuPriority 、 または ThreadDynamicCodePolicy を指定できます。

注意

ThreadDynamicCodePolicy は、Windows Server 2016以降、WINDOWS 10 LTSB 2016 以降、およびバージョン 1607 以降Windows 10サポートされています。

ThreadInformation

ThreadInformationClass パラメーターで指定された情報の種類を受け取る構造体へのポインター。

ThreadInformationClass パラメーターが ThreadMemoryPriority の場合、このパラメーターはMEMORY_PRIORITY_INFORMATION構造体を指す必要があります。

ThreadInformationClass パラメーターが ThreadAbsoluteCpuPriority の場合、このパラメーターは LONG を指す必要があります。

ThreadInformationClass パラメーターが ThreadDynamicCodePolicy の場合、このパラメーターは DWORD を指す必要があります。

[in] ThreadInformationSize

ThreadInformation パラメーターで指定された構造体のサイズ (バイト単位)。

ThreadInformationClass パラメーターが ThreadMemoryPriority の場合、このパラメーターは であるsizeof(MEMORY_PRIORITY_INFORMATION)必要があります。

ThreadInformationClass パラメーターが ThreadAbsoluteCpuPriority の場合、このパラメーターは であるsizeof(LONG)必要があります。

ThreadInformationClass パラメーターが ThreadDynamicCodePolicy の場合、このパラメーターは であるsizeof(DWORD)必要があります。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	processthreadsapi.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

GetProcessInformation、 SetThreadInformation