以下是该函数的原型:
DWORD DsRoleGetPrimaryDomainInformation(
LPCWSTR lpServer,
DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
PBYTE *Buffer
);
参数说明:
- lpServer:指定计算机的名称。如果为 NULL,则函数使用本地计算机。
- InfoLevel:指定要检索的信息级别,可以是 DsRolePrimaryDomainInfoBasic 或 DsRoleUpgradeStatus.
- Buffer:指向包含检索到的信息的缓冲区的指针。此缓冲区必须由调用方通过 DsRoleFreeMemory 函数释放。
返回值是操作的结果,如果函数调用成功,返回 ERROR_SUCCESS,否则返回相应的错误代码。
示例用法:
DSROLE_PRIMARY_DOMAIN_INFO_BASIC *pDomainInfo = NULL;
DWORD dwResult = DsRoleGetPrimaryDomainInformation(NULL, DsRolePrimaryDomainInfoBasic, (PBYTE*)&pDomainInfo);
if (dwResult == ERROR_SUCCESS) {
// 使用 pDomainInfo 中的信息
// 释放内存
DsRoleFreeMemory(pDomainInfo);
}
上述示例中的 DSROLE_PRIMARY_DOMAIN_INFO_BASIC 结构包含了域的基本信息,具体的使用方式和含义会依赖于具体的信息级别。释放内存时应该使用相应类型的指针。
转载请注明出处:http://www.zyzy.cn/article/detail/27345/Win32 API/Dsrole.h/DsRoleGetPrimaryDomainInformation