Condividi tramite


Funzione ConvertInterfaceIndexToLuid

La funzione ConvertInterfaceIndexToLuid converte un indice locale per un'interfaccia di rete nell'identificatore univoco locale (LUID) 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 ConvertInterfaceIndexToLuid(
  _In_  NET_IFINDEX InterfaceIndex,
  _Out_ PNET_LUID   InterfaceLuid
);

Parametri

  • InterfaceIndex [in]
    Valore dell'indice locale per l'interfaccia di rete.

  • InterfaceLuid [out]
    Puntatore all'unione NET_LUID per l'interfaccia di rete.

Valore restituito

ConvertInterfaceIndexToLuid restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, il parametro InterfaceLuid è impostato su NULL e ConvertInterfaceIndexToLuid restituisce il codice di errore seguente:

Codice restituito Descrizione
STATUS_INVALID_PARAMETER

Uno dei parametri non è valido. ConvertInterfaceIndexToLuid restituisce questo errore se il parametro InterfaceLuid è NULL o se il parametro InterfaceIndex non è valido.

Commenti

La funzione ConvertInterfaceIndexToLuid è indipendente dal protocollo e funziona con 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

Vedi anche

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID