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)

Weitere Informationen

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient