Condividi tramite


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

Vedi anche

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID