Share via

dsRoleGetPrimaryDomainInformation 函数 (dsrole.h)

  • 项目

DsRoleGetPrimaryDomainInformation 函数检索计算机的状态数据。 此数据包括目录服务安装和域数据的状态。

语法

DWORD DsRoleGetPrimaryDomainInformation(
  [in]  LPCWSTR                          lpServer,
  [in]  DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
  [out] PBYTE                            *Buffer
);

参数

[in] lpServer

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含调用函数的计算机的名称。 如果此参数为 NULL，则使用本地计算机。

[in] InfoLevel

包含指定要检索的数据类型的 DSROLE_PRIMARY_DOMAIN_INFO_LEVEL 值之一。 此参数还确定 Buffer 中提供的数据的格式。

[out] Buffer

指向接收请求数据的缓冲区地址的指针。 此数据的格式取决于 InfoLevel 参数的值。

调用 DsRoleFreeMemory 不再需要此内存时，调用方必须释放此内存。

返回值

如果函数成功，则 返回值ERROR_SUCCESS。

如果函数失败，则返回值可以是以下值之一。

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 dsrole.h
Library Netapi32.lib
DLL Netapi32.dll

另请参阅

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

目录服务函数

DsRoleFreeMemory