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

Статья
08/25/2023

Функция DsBindToISTG привязывается к компьютеру с ролью генератора топологии Inter-Site (ISTG) в домене локального компьютера.

Синтаксис

NTDSAPI_POSTXP DWORD DsBindToISTGA(
  [in, optional] LPCSTR SiteName,
  [out]          HANDLE *phDS
);

Параметры

[in, optional] SiteName

Указатель на строку, завершающуюся null, которая содержит имя сайта, используемое при привязке. Если этот параметр имеет значение NULL, используется сайт ближайшего контроллера домена.

[out] phDS

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

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

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

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

Требования

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

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

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

DsUnBind

Share via