Compartir a través de


Función DnsGetApplicationSettings (windns.h)

Recupera la configuración de DNS por aplicación.

Sintaxis

DWORD DnsGetApplicationSettings(
  DWORD                    *pcServers,
  DNS_CUSTOM_SERVER        **ppDefaultServers,
  DNS_APPLICATION_SETTINGS *pSettings
);

Parámetros

pcServers

Tipo: _Out_ * DWORD

Después de la llamada a la función, apuntará al número de servidores DNS personalizados que la aplicación ha configurado. Si no hay ningún servidor personalizado configurado o si se produce un error en la función, se establecerá en 0.

ppDefaultServers

Tipo: DNS_CUSTOM_SERVER** _Outptr_result_buffer_(*pcServers)

Después de la llamada a la función, apuntará a la matriz de servidores personalizados DNS configurados para la aplicación. Si la aplicación no tiene ningún servidor configurado o si se produce un error en la función, se establecerá en NULL.

pSettings

Tipo: _Out_opt_ DNS_APPLICATION_SETTINGS*

Puntero a un objeto DNS_APPLICATION_SETTINGS, rellenado con la configuración de la aplicación.

Valor devuelto

Un DWORD que contiene ERROR_SUCCESS correctos o un código de error en caso de error.

Observaciones

Para evitar pérdidas de memoria, debe llamar a dnsFreeCustomServers en los servidores devueltos por dnsGetApplicationSettings a través de su parámetro pSettings.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Build 22000
servidor mínimo admitido Windows Build 22000
de la plataforma de destino de Windows
encabezado de windns.h
biblioteca de Dnsapi.lib
DLL de Dnsapi.dll

Consulte también