DsRoleGetPrimaryDomainInformation 函数是 Windows 操作系统中的一个函数,属于 Win32 API,位于 Dsrole.h 头文件中。这个函数用于检索有关计算机在域中的成员身份的信息。

以下是该函数的原型:
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.pingtaimeng.com/article/detail/27345/Win32 API/Dsrole.h/DsRoleGetPrimaryDomainInformation