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) |