Share via

Função GetInterfaceDnsSettings (netioapi.h)

  • Artigo

Recupera as configurações de DNS da interface especificada no parâmetro Interface . Quando terminar o objeto de configurações retornado, você deverá chamar FreeInterfaceDnsSettings para liberá-lo.

Sintaxe

NETIOAPI_API GetInterfaceDnsSettings(
  GUID                   Interface,
  DNS_INTERFACE_SETTINGS *Settings
);

Parâmetros

Interface

Tipo: _In_ GUID

O GUID da interface COM à qual as configurações se referem.

Settings

Tipo: _Inout_ const DNS_INTERFACE_SETTINGS*

GetInterfaceDnsSettings preenche todas as configurações nessa estrutura.

Você deve definir apenas o membro Version ; o campo Sinalizadores deve estar vazio.

Se você definir o membro Version como DNS_INTERFACE_SETTINGS_VERSION1, o parâmetro Configurações deverá apontar para uma estrutura de DNS_INTERFACE_SETTINGS válida.

Se você definir o membro Version como DNS_INTERFACE_SETTINGS_VERSION2, o parâmetro Configurações deverá apontar para uma estrutura de DNS_INTERFACE_SETTINGS_EX válida.

Se você definir o membro Version como DNS_INTERFACE_SETTINGS_VERSION3, o parâmetro Configurações deverá apontar para uma estrutura de DNS_INTERFACE_SETTINGS3 válida.

Retornar valor

Retorna NO_ERROR se tiver êxito. Um valor de retorno diferente de zero indica falha.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 Build 19041
Servidor mínimo com suporte Windows 10 Build 19041
Plataforma de Destino Windows
Cabeçalho netioapi.h (inclua Iphlpapi.h)
Biblioteca Iphlpapi.lib
DLL Iphlpapi.dll

Confira também