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

Статья
02/29/2024

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

Синтаксис

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

Параметры

[in, optional] DomainControllerName

Указатель на строку, завершающуюся нулевым значением, которая содержит имя контроллера домена, к которому выполняется привязка. Это может быть имя контроллера домена или полное DNS-имя контроллера домена. При необходимости для любого типа имени могут предшествовать два символа обратной косой черты. Все следующие примеры представляют правильно отформатированные имена контроллеров домена:

"FAB-DC-01"
"\\FAB-DC-01"
"FAB-DC-01.fabrikam.com"
"\\FAB-DC-01.fabrikam.com"

Этот параметр может принимать значение NULL. Дополнительные сведения см. в подразделе "Примечания".

[in, optional] DnsDomainName

Указатель на строку, завершающуюся нулевым значением, которая содержит полное DNS-имя домена, к которому выполняется привязка. Этот параметр может принимать значение NULL. Дополнительные сведения см. в подразделе "Примечания".

[out] phDS

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

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

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

Поведение функции DsBind определяется содержимым параметров DomainControllerName и DnsDomainName . В следующем списке описывается поведение этой функции на основе содержимого этих параметров.

DomainControllerName	DnsDomainName	Описание
NULL	NULL	DsBind попытается выполнить привязку к серверу глобального каталога в лесу локального компьютера.
(значение)	NULL	DsBind попытается выполнить привязку к контроллеру домена, указанному параметром DomainControllerName .
NULL	(значение)	DsBind попытается выполнить привязку к любому контроллеру домена в домене, указанном параметром DnsDomainName .
(значение )	(значение)	Параметр DomainControllerName имеет приоритет. DsBind попытается выполнить привязку к контроллеру домена, указанному параметром DomainControllerName .

Примечание

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

Требования

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