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

Confira também

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient