IADsADSystemInfo::Metode GetDCSiteName (iads.h)

Artikel
02/26/2024

Metode IADsADSystemInfo::GetDCSiteName mengambil nama situs Direktori Aktif yang berisi komputer lokal.

Sintaks

HRESULT GetDCSiteName(
  [out] BSTR szServer,
  [in]  BSTR *pszSiteName
);

Parameter

[out] szServer

Nama situs Direktori Aktif.

[in] pszSiteName

Nama DNS server layanan.

Nilai kembali

Metode ini mendukung nilai pengembalian HRESULT standar. Untuk informasi selengkapnya, lihat Kode Kesalahan ADSI.

Keterangan

Situs Direktori Aktif adalah satu atau beberapa subnet TCP/IP yang terhubung dengan baik yang menyimpan pengontrol domain Direktori Aktif. Untuk informasi selengkapnya, lihat Konsep Inti Direktori Aktif.

Contoh

Contoh kode C++ berikut mengambil nama situs Direktori Aktif. 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 siteName;
   BSTR dnsServer;
   hr = pSys->GetAnyDCName(&dnsServer);

   if (SUCCEEDED(hr)) {
      printf("Domain controller: %S\n", dnsServer);

      hr = pSys->GetDCSiteName(&siteName);
      if (SUCCEEDED(hr)) {
          printf("Domain controller site: %S\n", siteName);
          SysFreeString(siteName);
      }

      SysFreeString(dnsServer);
   }

 
   if(pSys) {
      pSys->Release();
   }
 
   CoUninitialize();
   return 0;
}

Contoh kode Visual Basic berikut mengambil nama situs pengontrol domain Direktori Aktif.

Dim sys As New ADSystemInfo
dc = sys.GetAnyDCName
Debug.Print "Domain Controller site: " & sys.GetDCSiteName(dc)

Contoh kode VBScript/ASP berikut mengambil nama situs pengontrol domain Direktori Aktif.

<%
Dim sys

Set sys = CreateObject("ADSystemInfo")

dc = sys.GetAnyDCName

wscript.echo "Domain Controller     : " & dc
wscript.echo "Domain Controller site: " & sys.GetDCSiteName(dc)

%>

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll

Lihat juga

Kode Kesalahan ADSI

Konsep Inti Direktori Aktif

IADsADSystemInfo

Bagikan melalui