IADsADSystemInfo 屬性方法

IADsADSystemInfo介面的屬性方法會取得或設定下表所述的屬性。 如需詳細資訊，請參閱 Interface 屬性方法。

屬性

ComputerName

擷取本機電腦的辨別名稱。

存取類型：唯讀

腳本資料類型： 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
);

使用者名稱

擷取目前使用者的 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