Función ConvertInterfaceLuidToNameA (netioapi.h)

Artículo
03/15/2023

La función ConvertInterfaceLuidToNameA convierte un identificador único local (LUID) para una interfaz de red al nombre de la interfaz ANSI.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToNameA(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PSTR           InterfaceName,
  [in]  SIZE_T         Length
);

Parámetros

[in] InterfaceLuid

Puntero a un NET_LUID para una interfaz de red.

[out] InterfaceName

Puntero a un búfer que contiene la cadena ANSI terminada en NULL que contiene el nombre de la interfaz cuando la función devuelve correctamente.

[in] Length

Longitud, en bytes, del búfer al que apunta el parámetro InterfaceName . Este valor debe ser lo suficientemente grande como para dar cabida al nombre de la interfaz y al carácter nulo de terminación. La longitud máxima requerida es NDIS_IF_MAX_STRING_SIZE + 1.

Valor devuelto

Si se ejecuta correctamente, ConvertInterfaceLuidToNameA devuelve NETIO_ERROR_SUCCESS. Cualquier valor devuelto distinto de cero indica un error.

Código de error	Significado
ERROR_INVALID_PARAMETER	Uno de los parámetros no era válido. Este error se devuelve si interfaceLuid o el parámetro InterfaceName era NULL o si el parámetro InterfaceLuid no era válido.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente almacenamiento disponible para procesar este comando. Este error se devuelve si el tamaño del búfer al que apunta el parámetro InterfaceName no era lo suficientemente grande como se especifica en el parámetro Length para contener el nombre de la interfaz.

Comentarios

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

La función ConvertInterfaceLuidToNameA es independiente del protocolo y funciona con interfaces de red para el protocolo IPv6 e IPv4. ConvertInterfaceLuidToNameA convierte un LUID de interfaz de red en un nombre de interfaz ANSI.

ConvertInterfaceLuidToNameW convierte un LUID de interfaz de red en un nombre de interfaz Unicode.

La longitud máxima de un nombre de interfaz, NDIS_IF_MAX_STRING_SIZE, sin el valor NULL de terminación se declara en el archivo de encabezado Ntddndis.h . El NDIS_IF_MAX_STRING_SIZE se define como la constante IF_MAX_STRING_SIZE definida en el archivo de encabezado Ifdef.h . Los archivos de encabezado Ntddndis.h y Ifdef.h se incluyen automáticamente en el archivo de encabezado Netioapi.h , que el archivo de encabezado Iphlpapi.h incluye automáticamente. Los archivos de encabezado Ntddndis.h, Ifdef.h y Netioapi.h nunca se deben usar directamente.

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 (incluya Iphlpapi.h)
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll