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 |