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

Artigo
08/25/2023

A função StartProtocol inicializa a funcionalidade do protocolo de roteamento. O gerenciador de roteador usa essa função para passar os parâmetros de configuração global do protocolo de roteamento e um conjunto de pontos de entrada de API. O protocolo usa esses pontos de entrada para chamar o gerenciador de roteadores.

Sintaxe

PSTART_PROTOCOL PstartProtocol;

DWORD PstartProtocol(
  [in] HANDLE NotificationEvent,
  [in] PSUPPORT_FUNCTIONS SupportFunctions,
  [in] LPVOID GlobalInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Parâmetros

[in] NotificationEvent

Manipule para um objeto de evento. O protocolo de roteamento sinaliza esse evento quando ele deseja que o gerenciador de roteador recupere uma mensagem assíncrona da fila mantida pelo protocolo.

[in] SupportFunctions

Ponteiro para uma estrutura SUPPORT_FUNCTIONS . Os campos dessa estrutura são ponteiros para funções no gerenciador de roteadores. Essas funções permitem que o protocolo acesse informações que abrangem protocolos de roteamento.

[in] GlobalInfo

Ponteiro para informações de configuração globais definidas pelo protocolo, em vez de informações de configuração específicas da interface. Essas informações são privadas para o protocolo de roteamento.

[in] StructureVersion

Especifica a versão das estruturas de informações apontadas pelo parâmetro GlobalInfo . Em alguns casos, isso é igual à versão do protocolo de roteamento.

[in] StructureSize

Especifica o tamanho de cada uma das estruturas de informações apontadas pelo parâmetro GlobalInfo . Como algumas estruturas de informações contêm membros de comprimento variável, o protocolo de roteamento não é necessariamente capaz de determinar o tamanho das informações da versão.

[in] StructureCount

Especifica uma contagem do número de estruturas de informações apontadas pelo parâmetro GlobalInfo . Esse parâmetro é sempre um.

Retornar valor

Se a função for bem-sucedida e o protocolo estiver pronto para receber informações de interface, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor	Descrição
ERROR_CAN_NOT_COMPLETE	Falha na tentativa de inicializar o protocolo de roteamento.
ERROR_INVALID_PARAMETER	Um dos parâmetros apontados pelo parâmetro GlobalInfo é inválido.

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

GetEventMessage

Funções de interface de protocolo de roteamento

Referência da interface do protocolo de roteamento

SUPPORT_FUNCTIONS

StopProtocol

Compartilhar via