NPI_REGISTRATION_INSTANCE-Struktur (netioddk.h)
Die NPI_REGISTRATION_INSTANCE-Struktur definiert die Daten im Zusammenhang mit der Registrierung eines Netzwerkmoduls beim NMR.
Syntax
typedef struct _NPI_REGISTRATION_INSTANCE {
USHORT Version;
USHORT Size;
PNPIID NpiId;
PNPI_MODULEID ModuleId;
ULONG Number;
const VOID *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;
Member
Version
Die Version des NMR, bei der sich das Netzwerkmodul registriert. Ein Netzwerkmodul sollte diesen Member auf 0 festlegen.
Size
Die Größe der NPI_REGISTRATION_INSTANCE Struktur in Bytes.
NpiId
Ein Zeiger auf den NPI-Bezeichner für den spezifischen NPI, bei dem das Netzwerkmodul entweder als Client oder Anbieter registriert ist. Der NPIID-Datentyp ist definiert wie folgt:
typedef GUID NPIID;
typedef CONST NPIID *PNPIID;
ModuleId
Ein Zeiger auf eine NPI_MODULEID Struktur, die das Netzwerkmodul eindeutig identifiziert.
Number
Die Implementierungsnummer des NPI , für den das Netzwerkmodul entweder als Client oder Anbieter registriert ist. Ein Netzwerkmodul kann mehrere Implementierungen desselben NPI unterstützen, indem es sich entweder als Client oder als Anbieter jeder Implementierung des NPI registriert. Wenn nur eine Implementierung eines NPI vorhanden ist, wird dieser Member auf 0 festgelegt.
NpiSpecificCharacteristics
Ein Zeiger auf eine Struktur, die Merkmale angibt, die für das Netzwerkmodul eindeutig sind. Der Inhalt der Struktur ist NPI-spezifisch. Ein Netzwerkmodul sollte diesen Member auf NULL festlegen, wenn es sich als Client einer NPI registriert, die keine Clienteigenschaftenstruktur definiert, oder wenn es sich als Anbieter einer NPI registriert, die keine Anbietereigenschaftenstruktur definiert.
Hinweise
Eine NPI_REGISTRATION_INSTANCE-Struktur ist ein Element der NPI_CLIENT_CHARACTERISTICS und NPI_PROVIDER_CHARACTERISTICS Strukturen. Diese Strukturen werden für die Registrierung von Netzwerkmodulen beim NMR verwendet.
Wenn der NMR die ClientAttachProvider-Rückruffunktion eines Clientmoduls aufruft, übergibt er einen Zeiger an die NPI_REGISTRATION_INSTANCE Struktur für das Anbietermodul, an das sich das Clientmodul selbst anfügen kann. Wenn der NMR die ProviderAttachClient-Rückruffunktion eines Anbietermoduls aufruft, übergibt er einen Zeiger an die NPI_REGISTRATION_INSTANCE Struktur für das Clientmodul, an das sich das Anbietermodul selbst anfügen kann.
Ein Netzwerkmodul muss sicherstellen, dass der Arbeitsspeicher für die NPIID, auf die vom NpiId-Member verwiesen wird, der Speicher für die NPI_MODULEID Struktur, auf die vom ModuleId-Member verwiesen wird, und der Speicher für die strukturspezifischen NPI-spezifischen Merkmale, auf die vom NpiSpecificCharacteristics-Member verwiesen wird , gültig und im Arbeitsspeicher vorhanden bleiben, solange das Netzwerkmodul beim NMR registriert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Kopfzeile | netioddk.h (einschließen von Wsk.h) |