IADsADSystemInfo interface (iads.h)

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")

Inheritance

The IADsADSystemInfo interface inherits from the IDispatch interface. IADsADSystemInfo also has these types of members:

Methods

The IADsADSystemInfo interface has these methods.

 
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

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

See also

CoCreateInstance

IADsADSystemInfo Property Methods

IDispatch