Funzione ConvertInterfaceNameToLuidW (netioapi.h)

Articolo
03/05/2024

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

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidW(
  [in]  const WCHAR *InterfaceName,
  [out] NET_LUID    *InterfaceLuid
);

Parametri

[in] InterfaceName

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

[out] InterfaceLuid

Puntatore al NET_LUID per questa interfaccia.

Valore restituito

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

Codice di errore	Significato
ERROR_INVALID_NAME	Nome dell'interfaccia non valido. Questo errore viene restituito se il parametro InterfaceName contiene un nome non valido o la lunghezza del parametro InterfaceName ha superato la lunghezza massima consentita della stringa per questo parametro.
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido. Questo errore viene restituito se il parametro InterfaceLuid è NULL.

Commenti

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

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

ConvertInterfaceNameToLuidA 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