WskRegister 函数 (wsk.h)

鉴于应用程序的 WSK 客户端网络编程接口 (NPI ) ，WskRegister 函数注册 WSK 应用程序。

语法

NTSTATUS WskRegister(
  [in]  PWSK_CLIENT_NPI   WskClientNpi,
  [out] PWSK_REGISTRATION WskRegistration
);

[in] WskClientNpi

指向由 WSK 应用程序实现的客户端 NPI 的指针。

[out] WskRegistration

指向标识 WSK 应用程序的注册实例的内存位置的指针。此内存位置将由 WskRegister 调用初始化，并由其他 WSK 注册函数使用。 WSK 应用程序不应直接更改此内存位置的内容。

WskRegister 返回以下 NTSTATUS 代码之一：

返回代码	说明
STATUS_SUCCESS	注册成功。
其他状态代码	注册失败。

WSK 客户端对象可以多次调用此函数，但每次调用都必须使用不同的 WskRegistration 参数才能创建多个注册实例。

对于每次调用返回成功代码的 WskRegister，必须恰好有一个对应的 WskDeregister 调用使用传递给 WskRegister 的相同 WskRegistration 参数。

必须保持 分配 WskRegistration 指向的内存块， (不得释放或超出) 范围，只要对其他 WSK 注册函数有未完成调用。

使用 WskRegister 和 WskDeregister 函数是注册和注销 WSK 应用程序的首选方法。网络模块注册器仍可用于实现兼容性。

有关将 WSK 应用程序附加到 WSK 子系统的详细信息，请参阅注册 Winsock 内核应用程序。

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