IADsADSystemInfo：：GetDCSiteName 方法 (iads.h)

發行項
02/26/2024

IADsADSystemInfo：：GetDCSiteName 方法會擷取包含本機計算機的 Active Directory 網站名稱。

語法

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

參數

[out] szServer

Active Directory 網站的名稱。

[in] pszSiteName

服務伺服器的 DNS 名稱。

傳回值

這個方法支持標準 HRESULT 傳回值。如需詳細資訊，請參閱 ADSI 錯誤碼。

備註

Active Directory 月臺是保存 Active Directory 域控制器的一或多個連線良好的 TCP/IP 子網。如需詳細資訊，請參閱 Active Directory 核心概念。

範例

下列 C++ 程式代碼範例會擷取 Active Directory 網站名稱。為了簡潔起見，省略錯誤檢查。

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

下列 Visual Basic 程式代碼範例會擷取 Active Directory 域控制器網站的名稱。

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

下列 VBScript/ASP 程式代碼範例會擷取 Active Directory 域控制器網站的名稱。

<%
Dim sys

Set sys = CreateObject("ADSystemInfo")

dc = sys.GetAnyDCName

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

%>