Función ConvertInterfaceLuidToNameW
La función ConvertInterfaceLuidToNameW convierte un identificador único local (LUID) para una interfaz de red al nombre de la interfaz Unicode.
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 ConvertInterfaceLuidToNameW(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceName,
_In_ SIZE_T Length
);
Parámetros
InterfaceLuid [in]
Puntero a una unión de NET_LUID para la interfaz de red.InterfaceName [out]
Puntero a un búfer que contiene la cadena Unicode terminada en NULL. Si ConvertInterfaceLuidToNameW devuelve correctamente, InterfaceName contiene el nombre de la interfaz Unicode.Longitud [in]
Longitud del búfer, por recuento de caracteres, 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
ConvertInterfaceLuidToNameW devuelve STATUS_SUCCESS si la función se realiza correctamente. Si se produce un error en la función, ConvertInterfaceLuidToNameW 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. ConvertInterfaceLuidToNameW devuelve este error si InterfaceLuid o InterfaceName es NULL o si InterfaceLuid no es válido. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW 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 ConvertInterfaceLuidToNameW es independiente del protocolo y funciona con interfaces de red para los protocolos IPv6 e IPv4.
La longitud máxima del nombre de la 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. El 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 ConvertInterfaceLuidToNameA para convertir un LUID de interfaz de red en un nombre de interfaz ANSI.
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 |