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 ConvertInterfaceLuidToAlias converte un identificatore univoco locale (LUID) per un'interfaccia di rete in un alias di 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 ConvertInterfaceLuidToAlias(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceAlias,
_In_ SIZE_T Length
);
Parametri
InterfaceLuid [in]
Puntatore a un'unione NET_LUID per l'interfaccia di rete.InterfaceAlias [out]
Puntatore a un buffer per contenere la stringa Unicode con terminazione NULL. Se ConvertInterfaceLuidToAlias restituisce correttamente, InterfaceAlias contiene il nome alias dell'interfaccia di rete.lunghezza [in]
Lunghezza, per numero di caratteri, del buffer a cui punta il parametro interfaceAlias . Questo valore deve essere sufficientemente grande da contenere il nome alias dell'interfaccia di rete 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
convertInterfaceLuidToAlias restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione non riesce, ConvertInterfaceLuidToAlias restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceLuidToAlias restituisce questo errore se InterfaceLuid o InterfaceAlias è nullo se InterfaceLuid non è valido. |
| STATUS_NOT_ENOUGH_MEMORY | Spazio di archiviazione insufficiente. ConvertInterfaceLuidToAlias restituisce questo errore se le dimensioni del buffer a cui punta il parametro InterfaceAlias non corrisponde a quanto specificato nel parametro length Length e pertanto il buffer non può contenere il nome dell'alias. |
Osservazioni
La funzione ConvertInterfaceLuidToAlias è indipendente dal protocollo e funziona con le interfacce di rete per i protocolli IPv6 e IPv4.
La lunghezza massima del nome alias per un'interfaccia di rete, NDIS_IF_MAX_STRING_SIZE, senza il carattere NULL di terminazione, viene dichiarata 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.
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 |