Platform SDK: Active Directory, ADSI, and Directory Services

IADsADSystemInfo::GetDCSiteName

The IADsADSystemInfo::GetDCSiteName method retrieves the name of the Active Directory™ domain controller site that the Windows® 2000 system belongs to.

HRESULT IADsADSystemInfo::GetDCSiteName(
   BSTR *pbstrSiteName
);

Parameters

pbstrSiteName
[out, retval] Name of the Active Directory site.

Return Values

This method supports the standard HRESULT return values. For more information, see ADSI Error Codes.

Remarks

An Active Directory site is one or more well-connected TCP/IP subnets holding Active Directory domain controllers. For more information, see Active Directory Core Concepts.

Example Code [C++]

The following C++ code snippet retrieves the Active Directory site name. For brevity, error checking is omitted.

#include <activeds.h>
#include <stdio.h>
 
int main()
{
   HRESULT hr;
 
   hr = CoInitialize(NULL);
 
    IADsWinNTSystemInfo *pSys;
    hr = CoCreateInstance(CLSID_ADSystemInfo,
                          NULL,
                          CLSCTX_INPROC_SERVER,
                          IID_IADsADSystemInfo,
                          (void**)&pSys);
 
   BSTR bstr;
   hr = pSys->GetDCSiteName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("Domain controller site: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   if(pSys) {
      pSys->Release();
   }
 
   CoUninitialize();
   return 0;
}

Example Code [Visual Basic]

The following Visual Basic® code snippet retrieves the name of the Active Directory domain controller site.

Dim sys As New ADSystemInfo
Debug.Print "Domain Controller site: " & sys.GetDCSiteName

Example Code [VBScript]

The following VBScript/ASP code snippet retrieves the name of the Active Directory domain controller site.

<%
Dim sys
Set sys = Server.CreateObject("ADSystemInfo")
Response.Write "Domain Controller: " & sys.GetDCSiteName
%>

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Iads.h.

See Also

IADsADSystemInfo, ADSI Error Codes, Active Directory Core Concepts