Win32 API 日本語リファレンス
ホーム › Networking.WinSock › LPWPUCLOSETHREAD

LPWPUCLOSETHREAD

コールバック

シグネチャ

INT LPWPUCLOSETHREAD(
    WSATHREADID* lpThreadId,
    INT* lpErrno
);

パラメーター

フィールド型説明
lpThreadIdWSATHREADID*スレッドコンテキストを識別する WSATHREADID 構造体へのポインターです。この構造体は、事前の WPUOpenCurrentThread の呼び出しによって初期化されている必要があります。
lpErrnoINT*エラーコードへのポインターです。

公式ドキュメント

WPUCloseThread 関数は、 WPUOpenCurrentThread の呼び出しで開かれたスレッドを閉じます。

戻り値

エラーが発生しなかった場合、 WPUOpenCurrentThread は 0 を返します。それ以外の場合は SOCKET_ERROR を返し、具体的なエラーコードは lpErrno で取得できます。

エラーコード 意味
WSANOTINITIALISED
この関数を使用する前に、 WSPStartup の呼び出しが成功している必要があります。

解説(Remarks)

WPUCloseThread 関数は、階層化サービスプロバイダーにおいて、 WPUOpenCurrentThread 関数の呼び出しで確保されたリソースを解放するために使用します。解放対象のスレッドは、lpThreadId が指す WSATHREADID 構造体で示されるスレッドです。

WPUOpenCurrentThread の呼び出しごとに、必ず WPUCloseThread の呼び出しが必要です。これら 2 つの関数は、 LPWSPSend などのオーバーラップ関数が、現在のスレッドよりも下位のサービスプロバイダー層で呼び出される場合に使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)