Funzione MgmGetProtocolOnInterface (mgm.h)

La funzione MgmGetProtocolOnInterface recupera l'ID protocollo del protocollo del protocollo di routing multicast proprietario dell'interfaccia specificata.

Sintassi

DWORD MgmGetProtocolOnInterface(
  [in]      DWORD  dwIfIndex,
  [in]      DWORD  dwIfNextHopAddr,
  [in, out] PDWORD pdwIfProtocolId,
  [in, out] PDWORD pdwIfComponentId
);

Parametri

[in] dwIfIndex

Specifica l'indice dell'interfaccia per cui recuperare l'ID protocollo.

[in] dwIfNextHopAddr

Specifica l'indirizzo dell'hop successivo che corrisponde all'indice specificato da dwIfIndex. I parametri dwIfIndex e dwIfNextHopIPAddr identificano in modo univoco un hop successivo su interfacce da punto a più punti. Un'interfaccia da punto a più punti è una connessione in cui un'interfaccia si connette a più reti. Esempi di interfacce da punto a più punti includono interfacce di accesso non broadcast (NBMA) e l'interfaccia interna in cui si connettono tutti i client di accesso esterno.

Per le interfacce di trasmissione (ad esempio interfacce Ethernet) o interfacce da punto a punto, identificate solo dal valore di dwIfIndex, specificare zero.

[in, out] pdwIfProtocolId

In input, il client deve fornire un puntatore a una posizione di memoria di dimensioni DWORD.

Nell'output , pdwIfProtocolId riceve l'ID del protocollo nell'interfaccia specificata da dwIfIndex.

[in, out] pdwIfComponentId

In input, il client deve fornire un puntatore a un valore DWORD .

Nell'output , pdwIfComponentId riceve l'ID componente per l'istanza del protocollo nell'interfaccia. Questo parametro viene usato con pdwIfProtocolId per identificare in modo univoco un'istanza di un protocollo di routing.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_CAN_NOT_COMPLETE	Impossibile completare la chiamata a questa funzione.
ERROR_NOT_FOUND	L'interfaccia specificata non è stata trovata dal gestore gruppi multicast.

 

 

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mgm.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

MgmReleaseInterfaceOwnership

MgmTakeInterfaceOwnership