Função ConvertInterfaceLuidToGuid (netioapi.h)

Artigo
08/25/2023

A função ConvertInterfaceLuidToGuid converte um LUID (identificador local exclusivo) para um adaptador de rede em um GUID (identificador global exclusivo) para a interface.

Sintaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToGuid(
  [in]  const NET_LUID *InterfaceLuid,
  [out] GUID           *InterfaceGuid
);

Parâmetros

[in] InterfaceLuid

Um ponteiro para um NET_LUID para um adaptador de rede.

[out] InterfaceGuid

Um ponteiro para o GUID dessa interface.

Retornar valor

Em caso de êxito, ConvertInterfaceLuidToGuid retorna NO_ERROR. Qualquer valor retornado diferente de zero indica falha e um NULL é retornado no parâmetro InterfaceGuid .

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

Comentários

A função ConvertInterfaceLuidToGuid está disponível no Windows Vista e posterior.

A função ConvertInterfaceLuidToGuid é independente de protocolo e funciona com adaptadores 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