(netioddk.h) NPI_CLIENT_CHARACTERISTICS 結構

NPI_CLIENT_CHARACTERISTICS結構會定義用戶端模組的特性。

語法

typedef struct _NPI_CLIENT_CHARACTERISTICS {
  USHORT                                 Version;
  USHORT                                 Length;
  PNPI_CLIENT_ATTACH_PROVIDER_FN         ClientAttachProvider;
  PNPI_CLIENT_DETACH_PROVIDER_FN         ClientDetachProvider;
  PNPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN ClientCleanupBindingContext;
  NPI_REGISTRATION_INSTANCE              ClientRegistrationInstance;
} NPI_CLIENT_CHARACTERISTICS;

成員

Version

用戶端註冊所在的NMR版本。 用戶端模組應該將此成員設定為零。

Length

NPI_CLIENT_CHARACTERISTICS 結構的大小,以位元組為單位。

ClientAttachProvider

用戶端模組 ClientAttachProvider 回呼函式的指標。

ClientDetachProvider

用戶端模組 ClientDetachProvider 回呼函式的指標。

ClientCleanupBindingContext

用戶端模組的指標 ClientCleanupBindingContext 回呼 函式。 如果用戶端模組未針對系結內容動態配置記憶體,而且不需要其他清除其系結內容,則用戶端模組不需要實作 ClientCleanupBindingContext 回呼 函式。 如果客戶端模組未實作 ClientCleanupBindingContext 回呼 函式,則此成員必須設定為 NULL

ClientRegistrationInstance

一個 NPI_REGISTRATION_INSTANCE 結構,指定用戶端模組的身分識別及其註冊的 NPI

備註

當用戶端模組向NMR註冊本身時,用戶端模組會將指標傳遞給 nmrRegisterClient 函式NPI_CLIENT_CHARACTERISTICS結構。

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

規格需求

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

另請參閱

ClientAttachProvider

ClientCleanupBindingContext

ClientDetachProvider

NPI_REGISTRATION_INSTANCE

NmrRegisterClient