WskRelease 函式會釋放 WSK 應用程式先前保留之 WSK_DATA_INDICATION 結構的連結清單。
WskRelease 可以根據套接字類型,以兩種不同的方式宣告。 本主題描述連線導向或接聽套接字 WskRelease。 如需數據報套接字,請參閱 WskRelease (datagram sockets)。
語法
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 |