Funzione ConvertInterfaceLuidToNameW
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 di 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 conteggio dei caratteri, a cui punta il parametro InterfaceName . Questo valore deve essere abbastanza grande per contenere il nome dell'interfaccia e il carattere NULL terminante. La lunghezza massima consentita è NDIS_IF_MAX_STRING_SIZE + 1. Per altre informazioni su NDIS_IF_MAX_STRING_SIZE, vedere la sezione Osservazioni seguenti.
Valore restituito
ConvertInterfaceLuidToNameW restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, 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 è NULL o se InterfaceLuid non è valido. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW restituisce questo errore se il buffer InterfaceName non era di grandi dimensioni specificato nel parametro Length e, pertanto, il buffer non poteva contenere il nome dell'interfaccia. |
Commenti
La funzione ConvertInterfaceLuidToNameW è indipendente dal protocollo e funziona con 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 terminante, è definita 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.
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 LUID dell'interfaccia di rete in un nome di interfaccia ANSI.
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
PASSIVE_LEVEL |