Функция DsBindWithCredA (ntdsapi.h)

Статья
03/13/2024

Функция DsBindWithCred привязывается к контроллеру домена, используя указанные учетные данные.

Синтаксис

NTDSAPI DWORD DsBindWithCredA(
  [in, optional] LPCSTR                   DomainControllerName,
  [in, optional] LPCSTR                   DnsDomainName,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  [out]          HANDLE                   *phDS
);

Параметры

[in, optional] DomainControllerName

Указатель на строку, завершающуюся нулевым значением, которая содержит полное DNS-имя домена для привязки. Дополнительные сведения об этом параметре см. в описании DomainControllerName в разделе DsBind .

[in, optional] DnsDomainName

Указатель на строку, завершающуюся нулевым значением, которая содержит полное DNS-имя домена, к которому выполняется привязка. Дополнительные сведения об этом параметре см. в описании DnsDomainName в разделе DsBind .

Этот параметр необходим для защиты проверки подлинности Kerberos.

[in, optional] AuthIdentity

Содержит значение RPC_AUTH_IDENTITY_HANDLE , представляющее учетные данные, используемые для привязки. The

Для получения этого значения используется функция DsMakePasswordCredentials. Если этот параметр имеет значение NULL, используются учетные данные вызывающего потока.

Перед освобождением этого дескриптора с помощью функции DsFreePasswordCredentials необходимо вызвать DsUnBind.

[out] phDS

Адрес значения HANDLE , получающего дескриптор привязки. Чтобы закрыть этот дескриптор, передайте его в функцию DsUnBind .

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

Возвращает ERROR_SUCCESS в случае успешного выполнения или кода ошибки Windows или RPC. Ниже приведены наиболее распространенные коды ошибок.

Заголовок ntdsapi.h определяет DsBindWithCred в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	ntdsapi.h
Библиотека	Ntdsapi.lib
DLL	Ntdsapi.dll