Condividi tramite


Funzione ConvertInterfaceAliasToLuid (netioapi.h)

La funzione ConvertInterfaceAliasToLuid converte un nome alias di interfaccia per un'interfaccia di rete nell'identificatore univoco locale (LUID) per l'interfaccia.

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

Parametri

[in] InterfaceAlias

Puntatore a una stringa Unicode con terminazione NULL contenente il nome alias dell'interfaccia di rete.

[out] InterfaceLuid

Puntatore al NET_LUID per questa interfaccia.

Valore restituito

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

Codice di errore Significato
ERROR_INVALID_PARAMETER
Uno dei parametri non è valido. Questo errore viene restituito se il parametro InterfaceAlias o InterfaceLuid è NULL o se il parametro InterfaceAlias non è valido.

Commenti

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

La funzione ConvertInterfaceAliasToLuid è indipendente dal protocollo e funziona con le 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 (include Iphlpapi.h)
Libreria Iphlpapi.lib
DLL Iphlpapi.dll

Vedi anche

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex