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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] ComputerName

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

[out] SiteName

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

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

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

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

Замечания

Функция dsGetSiteName не требует определенного доступа к указанному домену. Функция отправляется в службу NetLogon на компьютере, указанном ComputerName.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	dsgetdc.h
библиотеки	Netapi32.lib
DLL	Netapi32.dll

См. также

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

DsGetDcName

DsValidateSubnetName

NetApiBufferFree

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