Funzione ConvertInterfaceLuidToNameA (netioapi.h)
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 |
|---|---|
|
Uno dei parametri non è valido. Questo errore viene restituito se il parametro InterfaceLuid o InterfaceName era NULL o se il parametro InterfaceLuid non è valido. |
|
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 |