Функция DsRoleGetPrimaryDomainInformation (dsrole.h)
Функция DsRoleGetPrimaryDomainInformation извлекает данные о состоянии компьютера. Эти данные включают состояние установки службы каталогов и данные домена.
Синтаксис
DWORD DsRoleGetPrimaryDomainInformation(
[in] LPCWSTR lpServer,
[in] DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
[out] PBYTE *Buffer
);
Параметры
[in] lpServer
Указатель на строку Юникода, завершающуюся значением NULL, которая содержит имя компьютера, на котором требуется вызвать функцию. Если этот параметр имеет значение NULL, используется локальный компьютер.
[in] InfoLevel
Содержит одно из DSROLE_PRIMARY_DOMAIN_INFO_LEVEL значений, определяющих тип извлекаемых данных. Этот параметр также определяет формат данных, предоставленных в буфере.
[out] Buffer
Указатель на адрес буфера, получающего запрошенные данные. Формат этих данных зависит от значения параметра InfoLevel .
Вызывающий объект должен освободить эту память, если она больше не требуется, вызвав DsRoleFreeMemory.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих значений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | dsrole.h |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |