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

備註

提供者模組會在向NMR註冊本身時,將指標傳遞給 nmrRegisterProvider 函式NPI_PROVIDER_CHARACTERISTICS結構。

只要提供者模組向NMR註冊,提供者模組就必須確保此結構保持有效且保留在記憶體中。

規格需求

需求
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭 netioddk.h (包含 Wsk.h)

另請參閱

NPI_REGISTRATION_INSTANCE

NmrRegisterProvider

ProviderAttachClient

ProviderCleanupBindingContext

ProviderDetachClient