NPI_REGISTRATION_INSTANCE struttura (netioddk.h)

La struttura NPI_REGISTRATION_INSTANCE definisce i dati correlati alla registrazione di un modulo di rete con nmR.

Sintassi

typedef struct _NPI_REGISTRATION_INSTANCE {
  USHORT        Version;
  USHORT        Size;
  PNPIID        NpiId;
  PNPI_MODULEID ModuleId;
  ULONG         Number;
  const VOID    *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;

Members

Version

Versione di NMR con cui viene registrato il modulo di rete. Un modulo di rete deve impostare questo membro su zero.

Size

Dimensioni, in byte, della struttura NPI_REGISTRATION_INSTANCE.

NpiId

Puntatore all'identificatore NPI per l'npI specifico a cui il modulo di rete sta registrando come client o un provider. Il tipo di dati NPIID è definito come:

typedef GUID NPIID;
typedef CONST NPIID *PNPIID;

ModuleId

Puntatore a una struttura NPI_MODULEID che identifica in modo univoco il modulo di rete.

Number

Numero di implementazione dell'npI per cui il modulo di rete sta registrando come client o provider. Un modulo di rete può supportare più implementazioni dello stesso npI registrando come client o un provider di ogni implementazione dell'npI. Se è presente solo un'implementazione di un'entità criteri di rete, questo membro è impostato su zero.

NpiSpecificCharacteristics

Puntatore a una struttura che specifica caratteristiche univoche per il modulo di rete. Il contenuto della struttura è specifico dell'npI. Un modulo di rete deve impostare questo membro su NULL se sta registrando come client di un'entità criteri di rete che non definisce una struttura di caratteristiche client o se sta registrando come provider di un'entità criteri di rete che non definisce una struttura delle caratteristiche del provider.

Commenti

Una struttura NPI_REGISTRATION_INSTANCE è un membro dell'NPI_CLIENT_CHARACTERISTICS e NPI_PROVIDER_CHARACTERISTICS strutture. Queste strutture vengono usate per la registrazione dei moduli di rete con nmR.

Quando nmR chiama la funzione di callback clientAttachProvider del modulo client, passa un puntatore alla struttura NPI_REGISTRATION_INSTANCE per il modulo provider a cui il modulo client può collegarsi. Analogamente, quando il nmR chiama la funzione di callback providerAttachClient del modulo provider, passa un puntatore alla struttura NPI_REGISTRATION_INSTANCE per il modulo client a cui il modulo provider può collegarsi.

Un modulo di rete deve assicurarsi che la memoria per l'NPIID puntata dal membro NpiId , la memoria per la struttura NPI_MODULEID puntata dal membro ModuleId e la memoria per la struttura di caratteristiche specifiche di NPI puntata dal membro NpiSpecificCharacteristics rimangano validi e residenti in memoria purché il modulo di rete sia registrato con il nmR.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	netioddk.h (include Wsk.h)

Vedi anche

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient