Función ConvertInterfaceLuidToNameA
La función ConvertInterfaceLuidToNameA convierte un identificador único local (LUID) para una interfaz de red al nombre de la interfaz ANSI.
Nota
La familia ConvertInterfaceXxx API enumera los identificadores de todas las interfaces enlazadas a TCP/IP, que pueden incluir miniportes virtuales, filtros ligeros, adaptadores de túnel e interfaces físicas.
Sintaxis
NETIOAPI_API ConvertInterfaceLuidToNameA(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PSTR InterfaceName,
_In_ SIZE_T Length
);
Parámetros
InterfaceLuid [in]
Puntero a una unión de NET_LUID para una interfaz de red.InterfaceName [out]
Puntero a un búfer que contiene la cadena ANSI terminada en NULL. Si ConvertInterfaceLuidToNameA devuelve correctamente, InterfaceName contiene el nombre de la interfaz ANSI.Longitud [in]
Longitud, en bytes, del búfer al que apunta el parámetro InterfaceName . Este valor debe ser lo suficientemente grande como para contener el nombre de la interfaz y el carácter NULL de terminación. La longitud máxima permitida es NDIS_IF_MAX_STRING_SIZE + 1. Para obtener más información sobre NDIS_IF_MAX_STRING_SIZE, vea la siguiente sección Comentarios.
Valor devuelto
ConvertInterfaceLuidToNameA devuelve STATUS_SUCCESS si la función se realiza correctamente. Si se produce un error en la función, ConvertInterfaceLuidToNameA devuelve uno de los siguientes códigos de error:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Uno de los parámetros no es válido. ConvertInterfaceLuidToNameA devuelve este error si InterfaceLuid o InterfaceName es NULL o si InterfaceLuid no es válido. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameA devuelve este error si el búfer InterfaceName no era tan grande como se especifica en el parámetro Length y, por lo tanto, el búfer no pudo contener el nombre de la interfaz. |
Observaciones
La función ConvertInterfaceLuidToNameA es independiente del protocolo y funciona con interfaces de red para los protocolos IPv6 e IPv4.
La longitud máxima del nombre de una interfaz de red, NDIS_IF_MAX_STRING_SIZE, sin el carácter NULL de terminación, se define en el archivo de encabezado Ntddndis.h. NDIS_IF_MAX_STRING_SIZE se define como la constante IF_MAX_STRING_SIZE, que se define en el archivo de encabezado Ifdef.h.
Nota
Los archivos de encabezado Ntddndis.h e Ifdef.h se incluyen automáticamente en el archivo de encabezado Netioapi.h . Nunca debe usar los archivos de encabezado Ntddndis.h e Ifdef.h directamente.
Use la función ConvertInterfaceLuidToNameW para convertir un LUID de interfaz de red en un nombre de interfaz Unicode.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |