функция DnsAcquireContextHandle_A (windns.h)
Тип функции DnsAcquireContextHandle получает дескриптор контекста для набора учетных данных. Как и многие функции DNS, тип функции DnsAcquireContextHand le реализован в нескольких формах, чтобы упростить кодировку символов. В зависимости от используемой кодировки символов используйте одну из следующих функций:
- 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, Учетные данные указывает на структуру SEC_WINNT_AUTH_IDENTITY_W; в противном случае учетные данные указывает на структуру SEC_WINNT_AUTH_IDENTITY_A. Если это не указано, используются учетные данные вызывающей службы. Этот параметр является необязательным.
[out] pContext
Указатель на дескриптор, указывающий на возвращаемые учетные данные.
Возвращаемое значение
Возвращает подтверждение успешности после успешного завершения. В противном случае возвращает соответствующий код ошибки, зависящий от DNS, как определено в Winerror.h.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | windns.h |
| библиотеки |
Dnsapi.lib |
| DLL | Dnsapi.dll |