Directory Services

IADsADSystemInfo::GetAnyDCName

The IADsADSystemInfo::GetAnyDCName method retrieves the DNS name of a domain controller in the local computer's domain.

HRESULT GetAnyDCName( 
  BSTR* pszDCName
);

Parameters

pszDCName
[out] Name of a domain controller, such as "ADServer1.domain1.Fabrikam.com".

Return Values

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

Example Code [C++]

The following C++ code example retrieves the Windows 2000 system information. For brevity, error checking is omitted.

#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 bstr;
   hr = pSys->GetAnyDCName(&bstr);
   if (SUCCEEDED(hr)) {
	printf("Domain controller: %S\n", bstr);
	SysFreeString(bstr);
   }
 
   if(pSys) {
	pSys->Release();
   }
 
   CoUninitialize();
   return 0;
}

Example Code [Visual Basic]

The following Visual Basic code example uses the IADsADSystemInfo::GetAnyDCName method to retrieve the name of the Active Directory domain controller.

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

Example Code [VBScript]

The following VBScript/ASP code example uses the IADsADSystemInfo::GetAnyDCName method to retrieve the name of the Active Directory domain controller.

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

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Iads.h.

See Also

IADsADSystemInfo, ADSI Error Codes