PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST回调函数 (wsk.h)

项目
03/05/2024

WskRelease 函数释放以前由 WSK 应用程序保留的WSK_DATAGRAM_INDICATION结构的链接列表。

WskRelease 可以通过两种不同的方式声明，具体取决于套接字的类型。本主题介绍数据报套接字的 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 函数关闭套接字不会释放任何未完成的保留链接列表的结构。在应用程序调用 WskCloseSocket 函数关闭套接字之前，WSK 应用程序必须释放所有保留的结构链接列表。

要求

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台	通用
标头	wsk.h (包括 Wsk.h)
IRQL	<= DISPATCH_LEVEL