Funzione ConvertInterfaceLuidToAlias (netioapi.h)

Articolo
02/29/2024

La funzione ConvertInterfaceLuidToAlias converte un identificatore univoco locale (LUID) per un'interfaccia di rete in un alias di interfaccia.

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToAlias(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PWSTR          InterfaceAlias,
  [in]  SIZE_T         Length
);

Parametri

[in] InterfaceLuid

Puntatore a un NET_LUID per un'interfaccia di rete.

[out] InterfaceAlias

Puntatore a un buffer per contenere la stringa Unicode con terminazione NULL contenente il nome alias dell'interfaccia di rete quando la funzione viene restituita correttamente.

[in] Length

Lunghezza, in caratteri, del buffer a cui punta il parametro InterfaceAlias . Questo valore deve essere sufficientemente grande per contenere il nome alias dell'interfaccia di rete e il carattere NULL di terminazione. La lunghezza massima richiesta è NDIS_IF_MAX_STRING_SIZE + 1.

Valore restituito

In caso di esito positivo, ConvertInterfaceLuidToAlias restituisce NO_ERROR. Qualsiasi valore restituito diverso da zero indica un errore.

Codice di errore	Significato
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido. Questo errore viene restituito se il parametro InterfaceLuid o InterfaceAlias è NULL o se il parametro InterfaceLuid non è valido.
ERROR_NOT_ENOUGH_MEMORY	Non è disponibile spazio di archiviazione sufficiente per elaborare questo comando. Questo errore viene restituito se le dimensioni del buffer a cui punta il parametro InterfaceAlias non erano sufficientemente grandi come specificato nel parametro Length per contenere il nome dell'alias.

Commenti

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

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

La lunghezza massima del nome dell'alias per un'interfaccia di rete, NDIS_IF_MAX_STRING_SIZE, senza che il valore NULL di terminazione sia dichiarato nel file di intestazione Ntddndis.h . Il NDIS_IF_MAX_STRING_SIZE viene definito come costante IF_MAX_STRING_SIZE definita nel file di intestazione Ifdef.h . I file di intestazione Ntddndis.h e Ifdef.h vengono inclusi automaticamente nel file di intestazione Netioapi.h , incluso automaticamente dal file di intestazione Iphlpapi.h . I file di intestazione Ntddndis.h, Ifdef.h e Netioapi.h non devono mai essere usati direttamente.

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