Función ConvertInterfaceGuidToLuid (netioapi.h)

Artículo
03/15/2023

La función ConvertInterfaceGuidToLuid convierte un identificador único global (GUID) para una interfaz de red en el identificador único local (LUID) de la interfaz.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceGuidToLuid(
  [in]  const GUID *InterfaceGuid,
  [out] PNET_LUID  InterfaceLuid
);

Parámetros

[in] InterfaceGuid

Puntero a un GUID para una interfaz de red.

[out] InterfaceLuid

Puntero al NET_LUID para esta interfaz.

Valor devuelto

Si se ejecuta correctamente, ConvertInterfaceGuidToLuid devuelve NO_ERROR. Cualquier valor devuelto distinto de cero indica un error y se devuelve un valor NULL en el parámetro InterfaceLuid .

Código de error	Significado
ERROR_INVALID_PARAMETER	Uno de los parámetros no era válido. Este error se devuelve si el parámetro InterfaceAlias o InterfaceLuid era NULL o si el parámetro InterfaceGuid no era válido.

Comentarios

La función ConvertInterfaceGuidToLuid está disponible en Windows Vista y versiones posteriores.

La función ConvertInterfaceGuidToLuid es independiente del protocolo y funciona con interfaces de red para el protocolo IPv6 e IPv4.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	netioapi.h (include Iphlpapi.h)
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll