IADsADSystemInfo interface

The IADsADSystemInfo interface retrieves data about the local computer if it is running a Windows operating system in a Windows domain. For example, you can get the domain, site, and distinguished name of the local computer.

The IADsADSystemInfo interface is implemented on the ADSystemInfo object residing in adsldp.dll, which is included with the standard installation of ADSI on Windows 2000. You must explicitly create an instance of the ADSystemInfo object in order to call the methods on the IADsADSystemInfo interface. This requirement amounts to creating an ADSystemInfo instance with the CoCreateInstance function in C/C++.

IADsADSystemInfo *pADsys;
HRESULT hr = CoCreateInstance(CLSID_ADSystemInfo,
                              NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IADsADSystemInfo,
                              (void**)&pADsys);

You can also use the New operator in Visual Basic.

Dim adSys as New ADSystemInfo

Or you can call the CreateObject function in a scripting environment, supplying "ADSystemInfo" as the ProgID.

Dim adSys
Set adSys = CreateObject("ADSystemInfo")

Methods

The IADsADSystemInfo interface has these methods.

Method Description
IADsADSystemInfo::GetAnyDCName Retrieves the DNS name of a domain controller in the local computer's domain.
IADsADSystemInfo::GetDCSiteName Retrieves the name of the Active Directory site that contains the local computer.
IADsADSystemInfo::GetTrees Retrieves the DNS names of all the directory trees in the local computer's forest.
IADsADSystemInfo::RefreshSchemaCache The IADsADSystemInfo::RefreshSchemaCache method refreshes the Active Directory schema cache.

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header iads.h

See Also

CoCreateInstance

IADsADSystemInfo Property Methods

IDispatch