NPI_REGISTRATION_INSTANCE 結構 (netioddk.h)
NPI_REGISTRATION_INSTANCE結構會定義與使用NMR註冊網路模組相關的數據。
語法
typedef struct _NPI_REGISTRATION_INSTANCE {
USHORT Version;
USHORT Size;
PNPIID NpiId;
PNPI_MODULEID ModuleId;
ULONG Number;
const VOID *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;
成員
Version
網路模組所註冊的NMR版本。 網路模組應該將此成員設定為零。
Size
NPI_REGISTRATION_INSTANCE 結構的大小，以位元組為單位。
NpiId
網路模組註冊為用戶端或提供者之特定 NPI 之 NPI 識別碼的指標。 NPIID 資料類型定義為：
typedef GUID NPIID;
typedef CONST NPIID *PNPIID;
ModuleId
可唯一識別網路模組 之NPI_MODULEID 結構的指標。
Number
網路模組註冊為用戶端或提供者之 NPI 的實作編號。 網路模組可以藉由註冊為用戶端或每個 NPI 實作的提供者，來支援相同 NPI 的多個實作。 如果 NPI 只有一個實作，此成員會設定為零。
NpiSpecificCharacteristics
結構的指標，指定網路模組唯一的特性。 結構的內容是 NPI 特定的。 如果網路模組註冊為未定義用戶端特性結構的 NPI 用戶端，或註冊為未定義提供者特性結構的 NPI 提供者，則網路模組應將此成員設定為 NULL 。
備註
NPI_REGISTRATION_INSTANCE 結構是 NPI_CLIENT_CHARACTERISTICS 和的成員 NPI_PROVIDER_CHARACTERISTICS 結構。 這些結構用於向NMR註冊網路模組。
當NMR呼叫用戶端模組的 ClientAttachProvider 回呼函式時，它會將指標傳遞給用戶端模組可以附加本身之提供者模組的NPI_REGISTRATION_INSTANCE結構。 同樣地，當NMR呼叫提供者模組的 ProviderAttachClient 回呼函式時，它會將指標傳遞給提供者模組可以附加本身之用戶端模組的NPI_REGISTRATION_INSTANCE結構。
網路模組必須確定 NpiId 成員指向的 NPIID 記憶體、ModuleId 成員所指向之NPI_MODULEID結構的記憶體，以及 NpiSpecificCharacteristics 成員所指向之 NPI 特定特性結構的記憶體，只要網路模組向 NMR 註冊，記憶體中就會保持有效且駐留在記憶體中。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 標頭 | netioddk.h (包含 Wsk.h) |