Função MgmReleaseInterfaceOwnership (mgm.h)

  • Artigo

A função MgmReleaseInterfaceOwnership é usada por um cliente para renunciar à propriedade de uma interface. Quando essa função é chamada, todos os MFEs mantidos pelo gerenciador de grupo multicast em nome do cliente e para a interface especificada são excluídos.

Sintaxe

DWORD MgmReleaseInterfaceOwnership(
  [in] HANDLE hProtocol,
  [in] DWORD  dwIfIndex,
  [in] DWORD  dwIfNextHopAddr
);

Parâmetros

[in] hProtocol

Manipule para o protocolo obtido de uma chamada anterior para MgmRegisterMProtocol.

[in] dwIfIndex

Especifica o índice da interface a ser lançada.

[in] dwIfNextHopAddr

Especifica o endereço do próximo salto que corresponde ao índice especificado por dwIfIndex. Os parâmetros dwIfIndex e dwIfNextHopIPAddr identificam exclusivamente um próximo salto em interfaces ponto a ponto. Uma interface ponto a ponto é uma conexão em que uma interface se conecta a várias redes. Exemplos de interfaces ponto a multipoint incluem interfaces NBMA (acesso múltiplo não difundido) e a interface interna na qual todos os clientes discados se conectam.

Para interfaces de difusão (como interfaces Ethernet) ou interfaces ponto a ponto, que são identificadas apenas pelo valor de dwIfIndex, especifique zero.

Retornar valor

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

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

Valor Significado
ERROR_CAN_NOT_COMPLETE
 Não foi possível concluir a chamada para essa função.
ERROR_INVALID_PARAMETER
 Identificador inválido para um cliente ou a interface não foi encontrada.
 
 

Comentários

Um cliente deve liberar a propriedade de todas as interfaces que possui antes de se desregistrar com a função MgmDeRegisterMProtocol .

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 mgm.h
Biblioteca Rtm.lib
DLL Rtm.dll

Confira também

MgmDeRegisterMProtocol

MgmTakeInterfaceOwnership