Función ConvertInterfaceGuidToLuid
La función ConvertInterfaceGuidToLuid convierte un identificador único global (GUID) para una interfaz de red en el identificador único local (LUID) de la interfaz.
Nota
La familia ConvertInterfaceXxx API enumera los identificadores de todas las interfaces enlazadas a TCP/IP, que pueden incluir miniportes virtuales, filtros ligeros, adaptadores de túnel e interfaces físicas.
Sintaxis
NETIOAPI_API ConvertInterfaceGuidToLuid(
_In_ const GUID *InterfaceGuid,
_Out_ PNET_LUID InterfaceLuid
);
Parámetros
InterfaceGuid [in]
Puntero a un GUID para la interfaz de red.InterfaceLuid [out]
Puntero a la unión de NET_LUID para la interfaz de red.
Valor devuelto
ConvertInterfaceGuidToLuid devuelve STATUS_SUCCESS si la función se realiza correctamente. Si se produce un error en la función, el parámetro InterfaceLuid se establece en NULL y ConvertInterfaceGuidToLuid devuelve el código de error siguiente:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Uno de los parámetros no era válido. ConvertInterfaceGuidToLuid devuelve este error si InterfaceAlias o InterfaceLuid es NULL o si InterfaceGuid no es válido. |
Observaciones
La función ConvertInterfaceGuidToLuid es independiente del protocolo y funciona con interfaces de red para los protocolos IPv6 e IPv4.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |