IADsADSystemInfo::GetDCSiteName-Methode (iads.h)

Die IADsADSystemInfo::GetDCSiteName-Methode ruft den Namen des Active Directory-Standorts ab, der den lokalen Computer enthält.

Syntax

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

Parameter

[out] szServer

Name des Active Directory-Standorts.

[in] pszSiteName

DNS-Name des Dienstservers.

Rückgabewert

Diese Methode unterstützt die HRESULT-Standardrückgabewerte . Weitere Informationen finden Sie unter ADSI-Fehlercodes.

Hinweise

Ein Active Directory-Standort ist ein oder mehrere gut verbundene TCP/IP-Subnetze mit Active Directory-Domänencontrollern. Weitere Informationen finden Sie unter Active Directory Core-Konzepte.

Beispiele

Im folgenden C++-Codebeispiel wird der Name des Active Directory-Standorts abgerufen. Aus Gründen der Kürze wird die Fehlerüberprüfung ausgelassen.

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

Im folgenden Visual Basic-Codebeispiel wird der Name des Active Directory-Domänencontrollerstandorts abgerufen.

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

Im folgenden VBScript/ASP-Codebeispiel wird der Name des Active Directory-Domänencontrollerstandorts abgerufen.

<%
Dim sys

Set sys = CreateObject("ADSystemInfo")

dc = sys.GetAnyDCName

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

%>

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll

Weitere Informationen

ADSI-Fehlercodes

Active Directory-Kernkonzepte

IADsADSystemInfo