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

  • Artigo

O gerenciador de roteador chama a função GetMfeStatus para obter o status da MFE (entrada de encaminhamento multicast) para a interface, o endereço do grupo e o endereço de origem especificados.

O tipo PGET_MFE_STATUS define um ponteiro para essa função de retorno de chamada. GetMfeStatus é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PGET_MFE_STATUS PgetMfeStatus;

DWORD PgetMfeStatus(
  [in]  DWORD InterfaceIndex,
  [in]  DWORD GroupAddress,
  [in]  DWORD SourceAddress,
  [out] PBYTE StatusCode
)
{...}

Parâmetros

[in] InterfaceIndex

Especifica o índice da interface para este MFE.

[in] GroupAddress

Especifica o endereço do grupo multicast para este MFE.

[in] SourceAddress

Especifica o endereço de origem multicast para este MFE.

[out] StatusCode

Ponteiro para uma variável BYTE . O protocolo de roteamento deve preencher essa variável com um dos valores a seguir. O protocolo de roteamento deve selecionar o código de maior valor que se aplica.

Valor Significado
MFE_NO_ERROR
 Nenhum dos valores a seguir se aplica.
MFE_REACHED_CORE
 O computador local neste roteador é um roteador de ponto de encontro (RP)/core para o grupo multicast.
MFE_OIF_PRUNED
 Esse valor deve ser definido apenas pelo proprietário da interface de saída. O valor indica que não existem receptores downstream na interface de saída.
MFE_PRUNED_UPSTREAM
 Esse valor deve ser definido apenas pelo proprietário da interface de entrada. O valor indica que uma mensagem de prune foi enviada upstream.
MFE_OLD_ROUTER
 Esse valor deve ser definido apenas pelo proprietário da interface de entrada. O valor indica que o upstream vizinho não dá suporte ao mtrace.

Retornar valor

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

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

Valor Descrição
ERROR_CAN_NOT_COMPLETE
 O protocolo de roteamento não pôde concluir a solicitação.
ERROR_INVALID_PARAMETER
 O parâmetro InterfaceIndex é inválido (por exemplo, nenhuma interface existe com esse índice) ou o grupo ou endereço de origem é inválido.
 
 

Comentários

Somente protocolos de roteamento multicast precisam implementar essa função. Os protocolos de roteamento não multicast devem passar NULL como o valor do ponteiro para essa função no MPR_ROUTING_CHARACTERISTICS

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

GetNeighbors