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

Статья
11/20/2024

Функция 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
целевая платформа	Виндоус
заголовка	ntdsapi.h
библиотеки	Ntdsapi.lib
DLL	Ntdsapi.dll

См. также

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

DsUnBind

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