Función ConvertInterfaceIndexToLuid (netioapi.h)

Artículo
02/29/2024

La función ConvertInterfaceIndexToLuid convierte un índice local para una interfaz de red en el identificador único local (LUID) de la interfaz.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PNET_LUID   InterfaceLuid
);

Parámetros

[in] InterfaceIndex

Valor de índice local para una interfaz de red.

[out] InterfaceLuid

Puntero al NET_LUID para esta interfaz.

Valor devuelto

Si se ejecuta correctamente, ConvertInterfaceIndexToLuid 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_FILE_NOT_FOUND	El sistema no encuentra el archivo especificado. Este error se devuelve si la interfaz de red especificada por el parámetro InterfaceIndex no era un valor en el equipo local.
ERROR_INVALID_PARAMETER	Uno de los parámetros no era válido. Este error se devuelve si el parámetro InterfaceLuid era NULL o si el parámetro InterfaceIndex no era válido.

Comentarios

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

La función ConvertInterfaceIndexToLuid 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