PFN_WSK_RELEASE_DATA_INDICATION_LIST コールバック関数 (wsk.h)
WskRelease 関数は、WSK アプリケーションによって以前に保持されていた WSK_DATA_INDICATION 構造体のリンクされたリストを解放します。
WskRelease は、ソケットの種類に応じて、2 つの異なる方法で宣言できます。 このトピックでは、接続指向またはリッスン ソケット WskRelease について説明します。 データグラム ソケットについては、wskRelease (データグラム ソケット) を参照してください。
構文
PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;
NTSTATUS PfnWskReleaseDataIndicationList(
[in] PWSK_SOCKET Socket,
[in] PWSK_DATA_INDICATION DataIndication
)
{...}
パラメーター
[in] Socket
データの受信元のソケットのソケット オブジェクトを指定する WSK_SOCKET 構造体へのポインター。
[in] DataIndication
解放する構造体のリンクされたリストへのポインター。 このパラメーターに対して、WSK アプリケーションは、WskReceiveEvent または WskReceiveFromEvent イベント コールバック関数に渡された DataIndication パラメーター 指定する必要があります。
戻り値
WskRelease は、次のいずれかの NTSTATUS コードを返します。
| リターン コード | 形容 |
|---|---|
|
バッファーの一覧が正常に解放されました。 |
|
無効なパラメーターが指定されました。 |
備考
接続指向またはリッスンソケットの場合、WSK アプリケーションは、WskRelease 関数を呼び出して、WskReceiveEvent またはその WskReceiveFromEvent イベント コールバック関数からSTATUS_PENDINGを返すことによって、以前に保持していた WSK_DATA_INDICATION 構造体のリンクされたリストを解放します。
WskCloseSocket 関数を呼び出してソケットを閉じても、保持されている未解決のリンクされた構造体リストは解放されません。 WSK アプリケーションは、アプリケーションが wskCloseSocket 関数 呼び出してソケットを閉じる前に、保持されているすべてのリンクされた構造体リストを解放する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wsk.h (Wsk.h を含む) |
| IRQL | <= DISPATCH_LEVEL |
関連項目
WSK_PROVIDER_CONNECTION_DISPATCHWskCloseSocket の
WskReceiveEvent の
WskReceiveFromEvent の