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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in, optional] DomainControllerName

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

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

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

[in, optional] DnsDomainName

Указатель на строку, завершающую значение NULL, содержащую полное 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
целевая платформа	Виндоус
заголовка	ntdsapi.h
библиотеки	Ntdsapi.lib
DLL	Ntdsapi.dll

См. также

DOMAIN_CONTROLLER_INFO

функции управления доменами и репликацией

DsBindWithCred

DsGetDcName

DsUnBind

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