Função ConvertInterfaceAliasToLuid (netioapi.h)

Artigo
02/29/2024

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.

Sintaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

Parâmetros

[in] InterfaceAlias

Um ponteiro para uma cadeia de caracteres Unicode terminada em NULL que contém o nome do alias do adaptador de rede.

[out] InterfaceLuid

Um ponteiro para o NET_LUID para essa interface.

Retornar valor

Com êxito, ConvertInterfaceAliasToLuid retorna NO_ERROR. Qualquer valor retornado diferente de zero indica falha e um NULL é retornado no parâmetro InterfaceLuid .

Código do erro	Significado
ERROR_INVALID_PARAMETER	Um dos parâmetros era inválido. Esse erro será retornado se o parâmetro InterfaceAlias ou InterfaceLuid for NULL ou se o parâmetro InterfaceAlias for inválido.

Comentários

A função ConvertInterfaceAliasToLuid está disponível no Windows Vista e posteriores.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	netioapi.h (inclua Iphlpapi.h)
Biblioteca	Iphlpapi.lib
DLL	Iphlpapi.dll