Função MgmTakeInterfaceOwnership (mgm.h)

A função MgmTakeInterfaceOwnership é chamada por um cliente (como um protocolo de roteamento) quando está habilitada em uma interface.

Somente um cliente pode se apropriar de uma determinada interface a qualquer momento. A única exceção a essa regra é o IGMP. O IGMP pode coexistir com outro cliente em uma interface.

Sintaxe

DWORD MgmTakeInterfaceOwnership(
  [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 da qual assumir a propriedade.

[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.

Comentários

Um cliente deve assumir a propriedade de uma interface somente depois de se registrar no gerenciador de grupo multicast, mas antes de adicionar entradas de associação de grupo.

Requisitos

Confira também

MgmGetProtocolOnInterface

MgmRegisterMProtocol

MgmReleaseInterfaceOwnership