Función ConvertInterfaceLuidToNameW (netioapi.h)

Artículo
02/29/2024

La función ConvertInterfaceLuidToNameW convierte un identificador único local (LUID) para una interfaz de red en el nombre de la interfaz Unicode.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToNameW(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PWSTR          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 Unicode terminada en NULL que contiene el nombre de la interfaz cuando la función devuelve correctamente.

[in] Length

Número de caracteres de la matriz a la 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, ConvertInterfaceLuidToNameW 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 ConvertInterfaceLuidToNameW está disponible en Windows Vista y versiones posteriores.

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

ConvertInterfaceLuidToNameA convierte un nombre de interfaz ANSI en un LUID.

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