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


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

Функция 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