Функция DsGetSiteNameA (dsgetdc.h)

Статья
08/23/2023

Функция DsGetSiteName возвращает имя сайта, на котором находится компьютер. Для контроллера домена имя сайта — это расположение настроенного контроллера домена. Для рядовой рабочей станции или рядового сервера имя указывает сайт рабочей станции, настроенный в домене компьютера.

Синтаксис

DSGETDCAPI DWORD DsGetSiteNameA(
  [in]  LPCSTR ComputerName,
  [out] LPSTR  *SiteName
);

Параметры

[in] ComputerName

Указатель на строку, завершающуюся значением NULL, которая указывает имя сервера для отправки этой функции. Значение NULL подразумевает локальный компьютер.

[out] SiteName

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

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

Если функция возвращает сведения об учетной записи, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов ошибок.

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

Требования


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

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

Функции службы каталогов

DsGetDcName

DsValidateSubnetName

NetApiBufferFree

Share via