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 |