Поделиться через

функция DnsAcquireContextHandle_A (windns.h)

  • Статья

Тип функции DnsAcquireContextHandle получает дескриптор контекста для набора учетных данных. Как и многие функции DNS, тип функции DnsAcquireContextHandle реализуется в нескольких формах для упрощения кодирования символов. В зависимости от используемой кодировки символов используйте одну из следующих функций:

  • DnsAcquireContextHandle_A (_A для кодировки ANSI)
  • DnsAcquireContextHandle_W (_W для кодировки Юникода)

Синтаксис

DNS_STATUS DnsAcquireContextHandle_A(
  [in]           DWORD   CredentialFlags,
  [in, optional] PVOID   Credentials,
  [out]          PHANDLE pContext
);

Параметры

[in] CredentialFlags

Флаг, указывающий кодировку символов. Задайте значение TRUE для Юникода, false для ANSI.

[in, optional] Credentials

Указатель на структуру SEC_WINNT_AUTH_IDENTITY_W или структуру SEC_WINNT_AUTH_IDENTITY_A , содержащую имя, домен и пароль учетной записи, которая будет использоваться в безопасном динамическом обновлении. Если параметр CredentialFlags имеет значение TRUE, credentials указывает на структуру SEC_WINNT_AUTH_IDENTITY_W ; в противном случае credentials указывает на структуру SEC_WINNT_AUTH_IDENTITY_A . Если не указано, используются учетные данные вызывающей службы. Этот параметр является необязательным.

[out] pContext

Указатель на дескриптор, указывающий на возвращенные учетные данные.

Возвращаемое значение

Возвращает подтверждение успешного выполнения после успешного завершения. В противном случае возвращает соответствующий код ошибки ДЛЯ DNS, как определено в Winerror.h.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header windns.h
Библиотека Dnsapi.lib
DLL Dnsapi.dll

См. также раздел

DNS_RECORD

DnsQuery

SEC_WINNT_AUTH_IDENTITY