Funzione ConvertInterfaceNameToLuidW
La funzione ConvertInterfaceNameToLuidW converte un nome dell'interfaccia di rete Unicode nell'identificatore univoco locale (LUID) per l'interfaccia.
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 ConvertInterfaceNameToLuidW(
_In_ const WCHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parametri
InterfaceName [in]
Puntatore a una stringa Unicode con terminazione NULL contenente il nome dell'interfaccia di rete.InterfaceLuid [out]
Puntatore all'unione NET_LUID per questa interfaccia.
Valore restituito
ConvertInterfaceNameToLuidW restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, ConvertInterfaceNameToLuidW restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_NAME | Il nome dell'interfaccia non è valido. ConvertInterfaceNameToLuidW restituisce questo errore se il parametro InterfaceName contiene un nome non valido o la lunghezza del parametro InterfaceName supera la lunghezza massima consentita della stringa per questo parametro. |
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceNameToLuidW restituisce questo errore se il parametro InterfaceLuid è NULL. |
Commenti
La funzione ConvertInterfaceNameToLuidW è 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. 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 .
Utilizzare la funzione ConvertInterfaceNameToLuidA per convertire un nome di interfaccia ANSI in un LUID.
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 |