Метод 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)

%>

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	iads.h
DLL	Activeds.dll

См. также раздел

Коды ошибок ADSI

Основные понятия Active Directory

IADsADSystemInfo

Поделиться через