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)

另请参阅

NPI_REGISTRATION_INSTANCE

NmrRegisterProvider

ProviderAttachClient

ProviderCleanupBindingContext

ProviderDetachClient