IADsADSystemInfo 属性方法

IADsADSystemInfo 接口的属性方法获取或设置下表中所述的属性。 有关详细信息，请参阅 Interface 属性方法。

属性

计算机名

检索本地计算机的可分辨名称。

访问类型：只读

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_ComputerName(
  [out] BSTR* pbstrComputer
);

DomainDNSName

检索本地计算机的域的 DNS 名称，例如“domainName.companyName.com”。

访问类型：只读

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_DomainDNSName(
  [out] BSTR* pbstr
);

DomainShortName

检索本地计算机的域的短名称，例如“domainName”。

访问类型：只读

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_DomainShortName(
  [out] BSTR* pbstrDSN
);

ForestDNSName

检索本地计算机的林的 DNS 名称。

访问类型：只读

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_ForestDNSName(
  [out] BSTR* pbstr
);

IsNativeMode

确定本地计算机的域是本机模式还是混合模式。

访问类型：只读

脚本数据类型： BOOL

// C++ method syntax
HRESULT get_IsNativeMode(
  [out] BOOL* pvBool
);

PDCRoleOwner

检索本地计算机域中拥有主域控制器角色的 DC 的目录服务代理 （DSA） 对象的可分辨名称。

访问类型：只读

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_PDCRoleOwner(
  [out] BSTR* pbstr
);

SchemaRoleOwner

检索本地计算机林中拥有架构主角色的 DC 的目录服务代理 （DSA） 对象的可分辨名称。

访问类型：只读

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_SchemaRoleOwner(
  [out] BSTR* pbstr
);

SiteName

检索本地计算机的站点名称。

访问类型：只读

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_SiteName(
  [out] BSTR* pbstrSite
);

UserName

检索当前用户的 Active Directory 可分辨名称，即登录用户或由调用线程模拟的用户。

访问类型：只读

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_UserName(
  [out] BSTR* pbstrUser
);

示例

以下 C++ 代码示例检索 Windows 系统信息。 为简洁起见，省略错误检查。

#include <activeds.h>
#include <stdio.h>
 
int main()
{
   HRESULT hr;
 
   hr = CoInitialize(NULL);
 
    IADsADSystemInfo *pSys;
    hr = CoCreateInstance(CLSID_ADSystemInfo,
                          NULL,
                          CLSCTX_INPROC_SERVER,
                          IID_IADsADSystemInfo,
                          (void**)&pSys);
 
   BSTR bstr;
   hr = pSys->get_UserName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("User: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pSys->get_ComputerName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("Computer: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pSys->get_DomainDNSName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("Domain: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pSys->get_PDCRoleOwner(&bstr);
   if (SUCCEEDED(hr)) {
      printf("PDC Role owner: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   if(pSys) {
      pSys->Release();
   }
 
   CoUninitialize();
   return 0;
}

以下 Visual Basic 代码示例检索 Windows 系统信息。

Dim sys As New ADSystemInfo
Debug.print "User: " & sys.UserName
Debug.print "Computer: " & sys.ComputerName
Debug.print "Domain: " & sys.DomainDNSName
Debug.print "PDC Role Owner: " & sys.PDCRoleOwner

以下 VBScript/ASP 代码示例检索 Windows 系统信息。

<%
Dim sys
Set sys = CreateObject("ADSystemInfo")
Response.Write "User: " & sys.UserName
Response.Write "Computer: " & sys.ComputerName
Response.Write "Domain: " & sys.DomainDNSName
Response.Write "PDC Role Owner: " & sys.PDCRoleOwner
%>

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	Iads.h
DLL	Activeds.dll
IID	IID_IADsADSystemInfo定义为 5BB11929-AFD1-11D2-9CB9-0000F87A369E

另请参阅

IADsADSystemInfo

CoCreateInstance