estrutura NPI_REGISTRATION_INSTANCE (netioddk.h)
A estrutura NPI_REGISTRATION_INSTANCE define os dados relacionados ao registro de um módulo de rede com o NMR.
Sintaxe
typedef struct _NPI_REGISTRATION_INSTANCE {
USHORT Version;
USHORT Size;
PNPIID NpiId;
PNPI_MODULEID ModuleId;
ULONG Number;
const VOID *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;
Membros
Version
A versão do NMR com a qual o módulo de rede está se registrando. Um módulo de rede deve definir esse membro como zero.
Size
O tamanho, em bytes, da estrutura NPI_REGISTRATION_INSTANCE.
NpiId
Um ponteiro para o identificador de NPI para a NPI específica à qual o módulo de rede está se registrando como um cliente ou um provedor. O tipo de dados NPIID é definido como:
typedef GUID NPIID;
typedef CONST NPIID *PNPIID;
ModuleId
Um ponteiro para uma estrutura NPI_MODULEID que identifica exclusivamente o módulo de rede.
Number
O número de implementação do NPI para o qual o módulo de rede está se registrando como um cliente ou um provedor. Um módulo de rede pode dar suporte a várias implementações da mesma NPI registrando-se como um cliente ou um provedor de cada implementação da NPI. Se houver apenas uma implementação de um NPI, esse membro será definido como zero.
NpiSpecificCharacteristics
Um ponteiro para uma estrutura que especifica características exclusivas do módulo de rede. O conteúdo da estrutura é específico de NPI. Um módulo de rede deve definir esse membro como NULL se ele estiver se registrando como um cliente de uma NPI que não define uma estrutura de características do cliente ou se ele estiver se registrando como um provedor de uma NPI que não define uma estrutura de características do provedor.
Comentários
Uma estrutura NPI_REGISTRATION_INSTANCE é membro do NPI_CLIENT_CHARACTERISTICS e NPI_PROVIDER_CHARACTERISTICS estruturas. Essas estruturas são usadas para registrar módulos de rede com o NMR.
Quando a NMR chama a função de retorno de chamada ClientAttachProvider de um módulo cliente, ela passa um ponteiro para a estrutura NPI_REGISTRATION_INSTANCE do módulo do provedor ao qual o módulo cliente pode se anexar. Da mesma forma, quando a NMR chama a função de retorno de chamada ProviderAttachClient de um módulo de provedor, ela passa um ponteiro para a estrutura NPI_REGISTRATION_INSTANCE do módulo cliente ao qual o módulo do provedor pode se anexar.
Um módulo de rede deve garantir que a memória do NPIID apontado pelo membro NpiId , a memória da estrutura NPI_MODULEID apontada pelo membro ModuleId e a memória da estrutura de características específicas de NPI apontada pelo membro NpiSpecificCharacteristics permaneçam válidas e residentes na memória, desde que o módulo de rede seja registrado com a NMR.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Cabeçalho | netioddk.h (inclua Wsk.h) |