Funzione ConvertInterfaceLuidToNameA (netioapi.h)

Articolo
08/25/2023

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

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToNameA(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PSTR           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 ANSI con terminazione NULL contenente il nome dell'interfaccia quando la funzione restituisce correttamente.

[in] Length

Lunghezza, in byte, del buffer a cui punta il parametro InterfaceName . Questo valore deve essere abbastanza grande per supportare il nome dell'interfaccia e il carattere null terminante. La lunghezza massima richiesta è NDIS_IF_MAX_STRING_SIZE + 1.

Valore restituito

In caso di esito positivo, ConvertInterfaceLuidToNameA 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 era NULL o se il parametro InterfaceLuid non è valido.
ERROR_NOT_ENOUGH_MEMORY	L'archiviazione non è 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 ConvertInterfaceLuidToNameA è disponibile in Windows Vista e versioni successive.

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

ConvertInterfaceLuidToNameW converte un LUID dell'interfaccia di rete in un nome di interfaccia Unicode.

La lunghezza massima di un nome di interfaccia, NDIS_IF_MAX_STRING_SIZE, senza la terminazione NULL viene dichiarata nel file di intestazione Ntddndis.h . Il NDIS_IF_MAX_STRING_SIZE è 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 (includere Iphlpapi.h)
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll