PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST コールバック関数 (wsk.h)

[アーティクル]
08/08/2023

WskRelease 関数は、WSK アプリケーションによって以前に保持されていたWSK_DATAGRAM_INDICATION構造体のリンクされたリストを解放します。

WskRelease は、ソケットの種類に応じて、2 つの異なる方法で宣言できます。このトピックでは、データグラムソケットの WskRelease について説明します。接続指向またはリッスンソケットについては、「 WskRelease (接続指向またはリッスンソケット)」を参照してください。

構文

PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;

NTSTATUS PfnWskReleaseDatagramIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}

パラメーター

[in] Socket

データを受信したソケットのソケットオブジェクトを指定する WSK_SOCKET 構造体へのポインター。

[in] DatagramIndication

解放する構造体のリンクされたリストへのポインター。このパラメーターの場合、WSK アプリケーションは、WskReceiveEvent または WskReceiveFromEvent イベントコールバック関数に渡された DatagramIndication パラメーターを指定する必要があります。

戻り値

WskRelease は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	構造体の一覧が正常に解放されました。
STATUS_INVALID_PARAMETER	無効なパラメーターが指定されました。

注釈

WSK アプリケーションは、WskRelease 関数を呼び出して、WskReceiveEvent または WskReceiveFromEvent イベントコールバック関数からSTATUS_PENDINGを返すことによって、以前に保持していたWSK_DATAGRAM_INDICATION構造体のリンクされたリストを解放します。

WskCloseSocket 関数を呼び出してソケットを閉じても、保持されている未解決の構造体のリンクリストは解放されません。 WSK アプリケーションは、 WskCloseSocket 関数を呼び出してソケットを閉じる前に、保持されている構造体のリンクリストをすべて解放する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	wsk.h (Wsk.h を含む)
IRQL	<= DISPATCH_LEVEL