Função ConvertInterfaceAliasToLuid

Artigo
06/15/2023

A função ConvertInterfaceAliasToLuid converte um nome de alias de interface para um adaptador de rede para o LUID (identificador local exclusivo) para a interface.

Observação

A família de API ConvertInterfaceXxx enumera identificadores em todas as interfaces associadas ao TCP/IP, que podem incluir miniportos virtuais, filtros leves, adaptadores de túnel e interfaces físicas.

Sintaxe

NETIOAPI_API ConvertInterfaceAliasToLuid(
  _In_  const WCHAR     *InterfaceAlias,
  _Out_       PNET_LUID InterfaceLuid
);

Parâmetros

InterfaceAlias [in]
Um ponteiro para uma cadeia de caracteres Unicode terminada em NULL que contém o nome do alias do adaptador de rede.
InterfaceLuid [out]
Um ponteiro para a união NET_LUID para o adaptador de rede.

Retornar valor

ConvertInterfaceAliasToLuid retornará STATUS_SUCCESS se a função for bem-sucedida. Se a função falhar, o parâmetro InterfaceLuid será definido como NULL e ConvertInterfaceAliasToLuid retornará o seguinte código de erro:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um dos parâmetros era inválido. ConvertInterfaceAliasToLuid retornará esse erro se InterfaceAlias ou InterfaceLuid for NULL ou se InterfaceAlias for inválido.

Comentários

A função ConvertInterfaceAliasToLuid é independente de protocolo e funciona com interfaces de rede para os protocolos IPv6 e IPv4.

Requisitos

Plataforma de destino	Universal
Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Netioapi.h (inclua Netioapi.h)
Biblioteca	Netio.lib
IRQL	PASSIVE_LEVEL