Função GetInterfaceDnsSettings (netioapi.h)

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

Confira também

• SetInterfaceDnsSettings
• FreeInterfaceDnsSettings