Funzione ConvertInterfaceLuidToIndex
La funzione ConvertInterfaceLuidToIndex converte un identificatore univoco locale (LUID) per un'interfaccia di rete nell'indice locale per l'interfaccia.
Nota
La famiglia di API ConvertInterfaceXxx enumera gli identificatori su tutte le interfacce associate a TCP/IP, che possono includere miniport virtuali, filtri leggeri, schede di tunnel e interfacce fisiche.
Sintassi
NETIOAPI_API ConvertInterfaceLuidToIndex(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PNET_IFINDEX InterfaceIndex
);
Parametri
InterfaceLuid [in]
Puntatore a un'unione NET_LUID per l'interfaccia di rete.InterfaceIndex [out]
Valore dell'indice locale per l'interfaccia di rete.
Valore restituito
ConvertInterfaceLuidToIndex restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, il parametro InterfaceIndex è impostato su NET_IFINDEX_UNSPECIFIED e ConvertInterfaceLuidToIndex restituisce il codice di errore seguente:
Codice restituito | Descrizione |
---|---|
STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceLuidToIndex restituisce questo errore se InterfaceLuid o InterfaceIndex è NULL o se InterfaceLuid non è valido. |
Commenti
La funzione ConvertInterfaceLuidToIndex è indipendente dal protocollo e funziona con le interfacce di rete per i protocolli IPv6 e IPv4.
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
PASSIVE_LEVEL |