Funzione ConvertInterfaceLuidToNameW (netioapi.h)

Articolo
08/25/2023

La funzione ConvertInterfaceLuidToNameW converte un identificatore univoco locale (LUID) per un'interfaccia di rete nel nome dell'interfaccia Unicode.

Sintassi

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

Parametri

[in] InterfaceLuid

Puntatore a un NET_LUID per un'interfaccia di rete.

[out] InterfaceName

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

[in] Length

Numero di caratteri nella matrice a cui punta il parametro InterfaceName . Questo valore deve essere sufficientemente grande per contenere il nome dell'interfaccia e il carattere null di terminazione. La lunghezza massima richiesta è NDIS_IF_MAX_STRING_SIZE + 1.

Valore restituito

In caso di esito positivo, ConvertInterfaceLuidToNameW restituisce NETIO_ERROR_SUCCESS. 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 InterfaceName è 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 InterfaceName non sono sufficienti come specificato nel parametro Length per contenere il nome dell'interfaccia.

Commenti

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

La funzione ConvertInterfaceLuidToNameW è indipendente dal protocollo e funziona con le interfacce di rete per il protocollo IPv6 e IPv4. ConvertInterfaceLuidToNameW converte un LUID dell'interfaccia di rete in un nome di interfaccia Unicode.

ConvertInterfaceLuidToNameA converte un nome di interfaccia ANSI in un LUID.

La lunghezza massima di un nome di interfaccia, NDIS_IF_MAX_STRING_SIZE, senza che il valore NULL di terminazione venga 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