estructura NPI_REGISTRATION_INSTANCE (netioddk.h)
La estructura NPI_REGISTRATION_INSTANCE define los datos relacionados con el registro de un módulo de red con NMR.
Sintaxis
typedef struct _NPI_REGISTRATION_INSTANCE {
USHORT Version;
USHORT Size;
PNPIID NpiId;
PNPI_MODULEID ModuleId;
ULONG Number;
const VOID *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;
Miembros
Version
La versión de NMR con la que se registra el módulo de red. Un módulo de red debe establecer este miembro en cero.
Size
Tamaño, en bytes, de la estructura NPI_REGISTRATION_INSTANCE.
NpiId
Puntero al identificador NPI del NPI específico al que se registra el módulo de red como cliente o proveedor. El tipo de datos NPIID se define como:
typedef GUID NPIID;
typedef CONST NPIID *PNPIID;
ModuleId
Puntero a una estructura de NPI_MODULEID que identifica de forma única el módulo de red.
Number
Número de implementación del NPI para el que el módulo de red se registra como un cliente o un proveedor. Un módulo de red puede admitir varias implementaciones del mismo NPI registrando como un cliente o un proveedor de cada implementación del NPI. Si solo hay una implementación de un NPI, este miembro se establece en cero.
NpiSpecificCharacteristics
Puntero a una estructura que especifica las características que son exclusivas del módulo de red. El contenido de la estructura es específico de NPI. Un módulo de red debe establecer este miembro en NULL si se registra como un cliente de un NPI que no define una estructura de características de cliente o si se registra como proveedor de un NPI que no define una estructura de características del proveedor.
Comentarios
Una estructura de NPI_REGISTRATION_INSTANCE es miembro del NPI_CLIENT_CHARACTERISTICS y NPI_PROVIDER_CHARACTERISTICS estructuras. Estas estructuras se usan para registrar módulos de red con NMR.
Cuando el NMR llama a la función de devolución de llamada ClientAttachProvider de un módulo cliente, pasa un puntero a la estructura de NPI_REGISTRATION_INSTANCE para el módulo de proveedor al que el módulo cliente puede asociarse. Del mismo modo, cuando NMR llama a la función de devolución de llamada ProviderAttachClient de un módulo de proveedor, pasa un puntero a la estructura de NPI_REGISTRATION_INSTANCE para el módulo cliente al que el módulo del proveedor puede asociarse.
Un módulo de red debe asegurarse de que la memoria del NPIID a la que apunta el miembro NpiId , la memoria de la estructura de NPI_MODULEID a la que apunta el miembro ModuleId y la memoria de la estructura de características específicas de NPI a la que apunta el miembro NpiSpecificCharacteristics permanecen válidas y residentes en la memoria siempre que el módulo de red esté registrado con el NMR.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| Encabezado | netioddk.h (incluya Wsk.h) |