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