estrutura MPR40_SERVICE_CHARACTERISTICS (stm.h)

A estrutura MPR_SERVICE_CHARACTERISTICS contém informações usadas para registrar um protocolo de roteamento com o gerenciador de roteadores.

Sintaxe

typedef struct _MPR40_SERVICE_CHARACTERISTICS {
  DWORD                              dwVersion;
  DWORD                              dwProtocolId;
  DWORD                              fSupportedFunctionality;
  PIS_SERVICE                        pfnIsService;
  PDO_UPDATE_SERVICES                pfnUpdateServices;
  PCREATE_SERVICE_ENUMERATION_HANDLE pfnCreateServiceEnumerationHandle;
  PENUMERATE_GET_NEXT_SERVICE        pfnEnumerateGetNextService;
  PCLOSE_SERVICE_ENUMERATION_HANDLE  pfnCloseServiceEnumerationHandle;
  PGET_SERVICE_COUNT                 pfnGetServiceCount;
  PCREATE_STATIC_SERVICE             pfnCreateStaticService;
  PDELETE_STATIC_SERVICE             pfnDeleteStaticService;
  PBLOCK_CONVERT_SERVICES_TO_STATIC  pfnBlockConvertServicesToStatic;
  PBLOCK_DELETE_STATIC_SERVICES      pfnBlockDeleteStaticServices;
  PGET_FIRST_ORDERED_SERVICE         pfnGetFirstOrderedService;
  PGET_NEXT_ORDERED_SERVICE          pfnGetNextOrderedService;
} MPR40_SERVICE_CHARACTERISTICS;

Membros

dwVersion

Na entrada, especifica a versão do RRAS em execução no momento.

Na saída, o protocolo de roteamento deve especificar a versão do RRAS necessária.

O símbolo MS_ROUTER_VERSION no arquivo de cabeçalho Routprot.h é definido como a versão do RRAS para uma determinada implementação.

dwProtocolId

Especifica o protocolo de roteamento que o gerenciador de roteador solicita que a DLL registre. (Um espaço de nome comum é usado para todas as famílias de protocolo.)

fSupportedFunctionality

Na entrada, especifica a funcionalidade à qual o gerenciador de roteador dá suporte.

Na saída, o protocolo de roteamento deve redefinir esses sinalizadores para indicar o subconjunto de funcionalidade compatível. Se esse protocolo de roteamento não fornecer serviços, fSupportedFunctionality deverá ser zero.

Esse parâmetro é um ou mais dos valores a seguir.

Valor	Significado
ROTEAMENTO	O protocolo participa do roteamento de vários protocolos importando APIs do gerenciador de tabelas de roteamento. Há um gerenciador de tabelas de roteamento que mantém uma tabela para cada família de protocolos (como IP e IPX).
SERVIÇOS	O protocolo assume a responsabilidade pelo gerenciamento de serviços (como o IPX SAP) e fornece APIs de Gerenciamento de Tabela de Serviço.
DEMAND_UPDATE_ROUTES	O protocolo é capaz de executar atualizações autostáticas de rotas quando solicitado pelo gerenciador de roteadores.
DEMAND_UPDATE_SERVICES	O protocolo é capaz de executar atualizações autostáticas de serviços quando solicitado pelo gerenciador de roteadores.

pfnIsService

Ponteiro para uma implementação da função IsService para esse protocolo de roteamento.

pfnUpdateServices

pfnCreateServiceEnumerationHandle

Ponteiro para uma implementação da função CreateServiceEnumerationHandle para esse protocolo de roteamento.

pfnEnumerateGetNextService

Ponteiro para uma implementação da função EnumerateGetNextService para esse protocolo de roteamento.

pfnCloseServiceEnumerationHandle

Ponteiro para uma implementação da função CloseServiceEnumerationHandle para esse protocolo de roteamento.

pfnGetServiceCount

Ponteiro para uma implementação da função GetServiceCount para esse protocolo de roteamento.

pfnCreateStaticService

Ponteiro para uma implementação da função CreateStaticService para esse protocolo de roteamento.

pfnDeleteStaticService

Ponteiro para uma implementação da função DeleteStaticService para esse protocolo de roteamento.

pfnBlockConvertServicesToStatic

Ponteiro para uma implementação da função BlockConvertServicesToStatic para esse protocolo de roteamento.

pfnBlockDeleteStaticServices

Ponteiro para uma implementação da função BlockDeleteStaticServices para esse protocolo de roteamento.

pfnGetFirstOrderedService

Ponteiro para uma implementação da função GetFirstOrderedService para esse protocolo de roteamento.

pfnGetNextOrderedService

Ponteiro para uma implementação da função GetNextOrderedService para esse protocolo de roteamento.

Comentários

Os membros dessa estrutura são ponteiros para as funções de Gerenciamento de Tabela de Serviço implementadas na DLL do protocolo de roteamento. O protocolo de roteamento preenche os valores de endereço desses ponteiros durante uma chamada para a função RegisterProtocol .

Somente as DLLs de protocolo de roteamento que dão suporte a serviços precisam preencher a estrutura MPR_SERVICE_CHARACTERISTICS .

Para obter uma descrição completa de uma função específica apontada por um dos membros da estrutura, consulte a página de referência para essa função.

Para usar essa estrutura, o usuário deve adicionar -DMPR50=1 aos sinalizadores do compilador.

Requisitos

Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	stm.h

Confira também

MPR_ROUTING_CHARACTERISTICS

Identificadores de protocolo

RegisterProtocol

Referência da interface do protocolo de roteamento

Estruturas de interface de protocolo de roteamento