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


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

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

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

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

DsRoleFreeMemory