Compartir a través de


Función ConvertInterfaceNameToLuidA (netioapi.h)

La función ConvertInterfaceNameToLuidA convierte un nombre de interfaz de red ANSI en el identificador único local (LUID) de la interfaz.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidA(
  [in]  const CHAR *InterfaceName,
  [out] NET_LUID   *InterfaceLuid
);

Parámetros

[in] InterfaceName

Puntero a una cadena ANSI terminada en NULL que contiene el nombre de la interfaz de red.

[out] InterfaceLuid

Puntero al NET_LUID para esta interfaz.

Valor devuelto

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

Código de error Significado
ERROR_BUFFER_OVERFLOW
La longitud del nombre de la interfaz ANSI no era válida. Este error se devuelve si el parámetro InterfaceName superó la longitud máxima de cadena permitida para este parámetro.
ERROR_INVALID_NAME
El nombre de la interfaz no era válido. Este error se devuelve si el parámetro InterfaceName contenía un nombre no válido.
ERROR_INVALID_PARAMETER
Uno de los parámetros no era válido. Este error se devuelve si el parámetro InterfaceLuid era NULL.

Comentarios

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

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

ConvertInterfaceNameToLuidW convierte un nombre de interfaz Unicode 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

Consulte también

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex