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 ConvertInterfaceNameToLuidW converte un nome di 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 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 non riesce, 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. |
Osservazioni
La funzione ConvertInterfaceNameToLuidW è 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. NDIS_IF_MAX_STRING_SIZE è definita 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 la funzione ConvertInterfaceNameToLuidA per convertire un nome di interfaccia ANSI in un LUID.
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 |