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