Función ConvertInterfaceLuidToAlias
La función ConvertInterfaceLuidToAlias convierte un identificador único local (LUID) para una interfaz de red en un alias de interfaz.
Nota
La familia de API ConvertInterfaceXxx 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 ConvertInterfaceLuidToAlias(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceAlias,
_In_ SIZE_T Length
);
Parámetros
InterfaceLuid [in]
Puntero a una unión NET_LUID para la interfaz de red.InterfaceAlias [out]
Puntero a un búfer que contiene la cadena Unicode terminada en NULL. Si ConvertInterfaceLuidToAlias devuelve correctamente, InterfaceAlias contiene el nombre de alias de la interfaz de red.Longitud [in]
Longitud, por recuento de caracteres, del búfer al que apunta el parámetro InterfaceAlias . Este valor debe ser lo suficientemente grande como para contener el nombre de alias de la interfaz de red 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
ConvertInterfaceLuidToAlias devuelve STATUS_SUCCESS si la función se realiza correctamente. Si se produce un error en la función, ConvertInterfaceLuidToAlias 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. ConvertInterfaceLuidToAlias devuelve este error si InterfaceLuid o InterfaceAlias es NULL o si InterfaceLuid no es válido. |
| STATUS_NOT_ENOUGH_MEMORY | No hay suficiente almacenamiento disponible. ConvertInterfaceLuidToAlias devuelve este error si el tamaño del búfer al que apunta el parámetro InterfaceAlias no era tan grande como se especifica en el parámetro Length y, por lo tanto, el búfer no pudo contener el nombre del alias. |
Observaciones
La función ConvertInterfaceLuidToAlias es independiente del protocolo y funciona con interfaces de red para los protocolos IPv6 e IPv4.
La longitud máxima del nombre de alias para una interfaz de red, NDIS_IF_MAX_STRING_SIZE, sin el carácter NULL de terminación, se declara 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 y Ifdef.h se incluyen automáticamente en el archivo de encabezado Netioapi.h . Nunca debe usar los archivos de encabezado Ntddndis.h y Ifdef.h directamente.
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 |