Funzione ConvertInterfaceIndexToLuid (netioapi.h)

Articolo
03/15/2023

La funzione ConvertInterfaceIndexToLuid converte un indice locale per un'interfaccia di rete nell'identificatore univoco locale (LUID) per l'interfaccia.

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PNET_LUID   InterfaceLuid
);

Parametri

[in] InterfaceIndex

Valore dell'indice locale per un'interfaccia di rete.

[out] InterfaceLuid

Puntatore al NET_LUID per questa interfaccia.

Valore restituito

In caso di esito positivo, ConvertInterfaceIndexToLuid restituisce NO_ERROR. Qualsiasi valore restituito diverso da zero indica l'errore e viene restituito un valore NULL nel parametro InterfaceLuid .

Codice di errore	Significato
ERROR_FILE_NOT_FOUND	Non è possibile trovare il file specificato. Questo errore viene restituito se l'interfaccia di rete specificata dal parametro InterfaceIndex non era un valore nel computer locale.
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido. Questo errore viene restituito se il parametro InterfaceLuid era NULL o se il parametro InterfaceIndex non è valido.

Commenti

La funzione ConvertInterfaceIndexToLuid è disponibile in Windows Vista e versioni successive.

La funzione ConvertInterfaceIndexToLuid è indipendente dal protocollo e funziona con interfacce di rete per il protocollo IPv6 e IPv4.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	netioapi.h (includere Iphlpapi.h)
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll