Compartilhar via


PREGISTER_PROTOCOL função de retorno de chamada (routprot.h)

A função RegisterProtocol registra o protocolo de roteamento com o gerenciador de roteador. Ele também informa ao gerenciador de roteadores sobre a funcionalidade à qual o protocolo de roteamento dá suporte.

Sintaxe

PREGISTER_PROTOCOL PregisterProtocol;

DWORD PregisterProtocol(
  [in, out] PMPR_ROUTING_CHARACTERISTICS pRoutingChar,
  [in, out] PMPR_SERVICE_CHARACTERISTICS pServiceChar
)
{...}

Parâmetros

[in, out] pRoutingChar

Na entrada, ponteiro para uma estrutura MPR_ROUTING_CHARACTERISTICS .

Na saída, recebe ponteiros para funções implementadas para o protocolo de roteamento.

Consulte a página de referência da estrutura MPR_ROUTING_CHARACTERISTICS para obter mais informações sobre como usá-la com a função RegisterProtocol .

[in, out] pServiceChar

Na entrada, ponteiro para uma estrutura MPR_SERVICE_CHARACTERISTICS .

Na saída, recebe ponteiros para funções implementadas para o protocolo de roteamento.

Consulte a página de referência da estrutura MPR_SERVICE_CHARACTERISTICS para obter mais informações sobre como usá-la com a função RegisterProtocol .

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será ERROR_NOT_SUPPORTED.

Comentários

Todas as DLLs de protocolo de roteamento devem preencher valores para a estrutura MPR_ROUTING_CHARACTERISTICS .

As DLLs de protocolo de roteamento que fornecem serviços devem preencher valores para a estrutura MPR_SERVICE_CHARACTERISTICS . Se uma DLL de protocolo de roteamento não fornecer serviços, ela deverá preencher zero para o membro fSupportedFunctionality dessa estrutura, mas não precisará preencher valores para os outros membros.

Os protocolos de roteamento são implementados em DLLs no modo de usuário. Uma única DLL pode implementar vários protocolos de roteamento. Portanto, o gerenciador de roteadores pode chamar RegisterProtocol várias vezes, uma vez para cada protocolo de roteamento implementado na DLL.

Requisitos

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

Confira também

MPR_ROUTING_CHARACTERISTICS

MPR_SERVICE_CHARACTERISTICS

Funções de interface de protocolo de roteamento

Referência da interface do protocolo de roteamento