IADsADSystemInfo：：GetDCSiteName 方法 (iads.h)

项目
08/24/2023

IADsADSystemInfo：：GetDCSiteName 方法检索包含本地计算机的 Active Directory 站点的名称。

语法

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

参数

[out] szServer

Active Directory 站点的名称。

[in] pszSiteName

服务服务器的 DNS 名称。

返回值

此方法支持标准 HRESULT 返回值。有关详细信息，请参阅 ADSI 错误代码。

注解

Active Directory 站点是一个或多个连接良好的 TCP/IP 子网，包含 Active Directory 域控制器。有关详细信息，请参阅 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)

%>