Funzione ConvertInterfaceGuidToLuid
La funzione ConvertInterfaceGuidToLuid converte un identificatore univoco globale (GUID) per un'interfaccia di rete 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 ConvertInterfaceGuidToLuid(
_In_ const GUID *InterfaceGuid,
_Out_ PNET_LUID InterfaceLuid
);
Parametri
InterfaceGuid [in]
Puntatore a un GUID per l'interfaccia di rete.InterfaceLuid [out]
Puntatore all'unione NET_LUID per l'interfaccia di rete.
Valore restituito
ConvertInterfaceGuidToLuid restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, il parametro InterfaceLuid è impostato su NULL e ConvertInterfaceGuidToLuid restituisce il codice di errore seguente:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceGuidToLuid restituisce questo errore se InterfaceAlias o InterfaceLuid è NULL o se InterfaceGuid non è valido. |
Commenti
La funzione ConvertInterfaceGuidToLuid è indipendente dal protocollo e funziona con le interfacce di rete per i protocolli IPv6 e IPv4.
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 |