Metode Properti IADsADSystemInfo

Metode properti antarmuka IADSADSystemInfo mendapatkan atau mengatur properti yang dijelaskan dalam tabel berikut. Untuk informasi selengkapnya, lihat Metode Properti Antarmuka.

Properti

ComputerName

Mengambil nama khusus komputer lokal.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

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

DomainDNSName

Mengambil nama DNS domain komputer lokal, seperti "domainName.companyName.com".

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

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

DomainShortName

Mengambil nama pendek domain komputer lokal, seperti "domainName".

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

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

ForestDNSName

Mengambil nama DNS forest komputer lokal.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

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

IsNativeMode

Menentukan apakah domain komputer lokal berada dalam mode asli atau campuran.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BOOL

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

PDCRoleOwner

Mengambil nama khusus objek agen layanan direktori (DSA) untuk DC yang memiliki peran pengendali domain utama di domain komputer lokal.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

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

SchemaRoleOwner

Mengambil nama khusus objek agen layanan direktori (DSA) untuk DC yang memiliki peran master skema di forest komputer lokal.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

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

SiteName

Mengambil nama situs komputer lokal.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

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

UserName

Mengambil nama pengguna yang dibedakan Active Directory saat ini, yang merupakan pengguna yang masuk atau pengguna yang ditiru oleh utas panggilan.

Jenis akses: Baca-saja

Jenis data pembuatan skrip: BSTR

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

Contoh

Contoh kode C++ berikut mengambil informasi sistem Windows. Untuk keringkasan, pemeriksaan kesalahan dihilangkan.

#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;
}

Contoh kode Visual Basic berikut mengambil informasi sistem 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

Contoh kode VBScript/ASP berikut mengambil informasi sistem 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
%>

Persyaratan

Lihat juga

IADsADSystemInfo

CoCreateInstance