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

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

Требования

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

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

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

DsRoleFreeMemory