NPI_PROVIDER_CHARACTERISTICS 结构 (netioddk.h)
NPI_PROVIDER_CHARACTERISTICS 结构定义提供程序模块的特征。
语法
typedef struct _NPI_PROVIDER_CHARACTERISTICS {
USHORT Version;
USHORT Length;
PNPI_PROVIDER_ATTACH_CLIENT_FN ProviderAttachClient;
PNPI_PROVIDER_DETACH_CLIENT_FN ProviderDetachClient;
PNPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN ProviderCleanupBindingContext;
NPI_REGISTRATION_INSTANCE ProviderRegistrationInstance;
} NPI_PROVIDER_CHARACTERISTICS;
成员
Version
提供程序注册到的 NMR 版本。 提供程序模块应将此成员设置为零。
Length
NPI_PROVIDER_CHARACTERISTICS结构的大小(以字节为单位)。
ProviderAttachClient
指向提供程序模块的 ProviderAttachClient 回调函数的指针。
ProviderDetachClient
指向提供程序模块的 ProviderDetachClient 回调函数的指针。
ProviderCleanupBindingContext
指向提供程序模块的 的指针 ProviderCleanupBindingContext 回调函数。 如果提供程序模块未为其绑定上下文动态分配内存,并且不需要对其绑定上下文进行其他清理,则提供程序模块不需要实现 ProviderCleanupBindingContext 回调函数。 如果提供程序模块未实现 ProviderCleanupBindingContext 回调函数,则此成员必须设置为 NULL。
ProviderRegistrationInstance
一个 NPI_REGISTRATION_INSTANCE 结构,用于指定要注册的提供程序模块和 NPI 的标识。
注解
提供程序模块将指向NPI_PROVIDER_CHARACTERISTICS结构的指针传递给 NmrRegisterProvider 函数时,该函数向 NMR 注册自身。
只要提供程序模块已注册到 NMR,提供程序模块就必须确保此结构保持有效并驻留在内存中。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
标头 | netioddk.h (包括 Wsk.h) |