Funzione ConvertInterfaceLuidToAlias (netioapi.h)
La funzione ConvertInterfaceLuidToAlias converte un identificatore univoco locale (LUID) per un'interfaccia di rete in un alias di interfaccia.
Sintassi
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToAlias(
[in] const NET_LUID *InterfaceLuid,
[out] PWSTR InterfaceAlias,
[in] SIZE_T Length
);
Parametri
[in] InterfaceLuid
Puntatore a un NET_LUID per un'interfaccia di rete.
[out] InterfaceAlias
Puntatore a un buffer per contenere la stringa Unicode con terminazione NULL contenente il nome alias dell'interfaccia di rete quando la funzione viene restituita correttamente.
[in] Length
Lunghezza, in caratteri, del buffer a cui punta il parametro InterfaceAlias . Questo valore deve essere sufficientemente grande per contenere il nome alias dell'interfaccia di rete e il carattere NULL di terminazione. La lunghezza massima richiesta è NDIS_IF_MAX_STRING_SIZE + 1.
Valore restituito
In caso di esito positivo, ConvertInterfaceLuidToAlias restituisce NO_ERROR. 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 InterfaceAlias è 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 InterfaceAlias non erano sufficientemente grandi come specificato nel parametro Length per contenere il nome dell'alias. |
Commenti
La funzione ConvertInterfaceLuidToAlias è disponibile in Windows Vista e versioni successive.
La funzione ConvertInterfaceLuidToAlias è indipendente dal protocollo e funziona con le interfacce di rete per il protocollo IPv6 e IPv4.
La lunghezza massima del nome dell'alias per un'interfaccia di rete, NDIS_IF_MAX_STRING_SIZE, senza che il valore NULL di terminazione sia 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 |