Funzione ConvertInterfaceNameToLuidA (netioapi.h)

Articolo
03/15/2023

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

Sintassi

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

Parametri

[in] InterfaceName

Puntatore a una stringa ANSI 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, ConvertInterfaceNameToLuidA restituisce NETIO_ERROR_SUCCESS. Qualsiasi valore restituito diverso da zero indica un errore.

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

Commenti

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

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

ConvertInterfaceNameToLuidW converte un nome di interfaccia Unicode in un LUID.

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