Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La funzione ConvertInterfaceLuidToNameW converte un identificatore univoco locale (LUID) per un'interfaccia di rete nel nome dell'interfaccia Unicode.
Nota
La famiglia di API ConvertInterfaceXxx enumera gli identificatori su tutte le interfacce associate a TCP/IP, che possono includere miniport virtuali, filtri leggeri, schede tunnel e interfacce fisiche.
Sintassi
NETIOAPI_API ConvertInterfaceLuidToNameW(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceName,
_In_ SIZE_T Length
);
Parametri
InterfaceLuid [in]
Puntatore a un'unione NET_LUID per l'interfaccia di rete.InterfaceName [out]
Puntatore a un buffer per contenere la stringa Unicode con terminazione NULL. Se ConvertInterfaceLuidToNameW restituisce correttamente, InterfaceName contiene il nome dell'interfaccia Unicode.lunghezza [in]
Lunghezza del buffer, in base al numero di caratteri, a cui punta il parametro InterfaceName. Questo valore deve essere sufficientemente grande da contenere il nome dell'interfaccia e il carattere NULL di terminazione. La lunghezza massima consentita è NDIS_IF_MAX_STRING_SIZE + 1. Per altre informazioni sulle NDIS_IF_MAX_STRING_SIZE, vedere la sezione Osservazioni seguente.
Valore restituito
ConvertInterfaceLuidToNameW restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione non riesce, ConvertInterfaceLuidToNameW restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceLuidToNameW restituisce questo errore se InterfaceLuid o InterfaceName è NULLo se InterfaceLuid non è valido. |
| STATUS_NOT_ENOUGH_MEMORY | convertInterfaceLuidToNameW restituisce questo errore se il buffer InterfaceName non è grande quanto specificato nel parametro Length e pertanto il buffer non può contenere il nome dell'interfaccia. |
Osservazioni
La funzione ConvertInterfaceLuidToNameW è indipendente dal protocollo e funziona con le interfacce di rete per i protocolli IPv6 e IPv4.
La lunghezza massima del nome dell'interfaccia di rete, NDIS_IF_MAX_STRING_SIZE, senza il carattere NULL di terminazione, viene definita 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.
Nota
I file di intestazione Ntddndis. h e Ifdef.h vengono inclusi automaticamente nel file di intestazione Netioapi.h. Non usare mai direttamente i file di intestazione Ntddndis. h e Ifdef.h.
Usare ConvertInterfaceLuidToNameA per convertire un'interfaccia di rete LUID in un nome di interfaccia ANSI.
Fabbisogno
Piattaforma di destinazione |
universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |