SHCreateThread 関数 (shlwapi.h)

[アーティクル]
03/05/2024

スレッドを作成します。

構文

BOOL SHCreateThread(
  [in]           LPTHREAD_START_ROUTINE pfnThreadProc,
  [in, optional] void                   *pData,
  [in]           SHCT_FLAGS             flags,
  [in, optional] LPTHREAD_START_ROUTINE pfnCallback
);

パラメーター

[in] pfnThreadProc

種類: LPTHREAD_START_ROUTINE

LPTHREAD_START_ROUTINE型のアプリケーション定義関数へのポインター。新しいスレッドが正常に作成された場合、このアプリケーション定義関数は、そのスレッドのコンテキストで呼び出されます。 SHCreateThread は、呼び出し元に戻る前に、このパラメーターが指す関数の完了を待機しません。アプリケーション定義関数の戻り値は、スレッドの終了コードです。

[in, optional] pData

型: void*

初期化データを含むオプションのアプリケーション定義データ構造へのポインター。 pfnThreadProc が指す関数と、必要に応じて pfnCallback に渡されます。この値には NULL を指定できます。

[in] flags

種類: SHCT_FLAGS

関数の動作を制御するフラグ。 1 つ以上の CTF 定数。

[in, optional] pfnCallback

種類: LPTHREAD_START_ROUTINE

LPTHREAD_START_ROUTINE型の省略可能なアプリケーション定義関数へのポインター。この関数は、 pfnThreadProc によって指される関数が呼び出される前に、作成されたスレッドのコンテキストで呼び出されます。また、引数として pData を受け取ります。 SHCreateThread は、 pfnCallback が指す関数が呼び出し元に戻るまで待機します。 pfnCallback が指す関数の戻り値は無視されます。

戻り値

種類: BOOL

スレッドが正常に作成された場合は TRUE 、それ以外の場合は FALSE を 返します。失敗した場合は、 GetLastError を使用して、次に示すように特定のエラー値を取得します。

if (!SHCreateThread(...))
{
    hr = HRESULT_FROM_WIN32( GetLastError() );
}
else
{
    ....
}

注釈

pfnThreadProc および pfnCallback が指す関数は、次の形式にする必要があります。

DWORD WINAPI ThreadProc(LPVOID pData)
{
  ...
}

関数名は任意です。 pData パラメーターは、初期化情報を含むアプリケーション定義のデータ構造を指します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 5.0 以降)