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")
Members
The IADsADSystemInfo interface inherits from the IDispatch interface. IADsADSystemInfo also has these types of members:
Methods
The IADsADSystemInfo interface has these methods.
| Method | Description |
|---|---|
| GetAnyDCName |
Retrieves the DNS name of a domain controller in the local computer domain. |
| GetDCSiteName |
Retrieves the name of the local computer site. |
| GetTrees |
Retrieves the DNS names of all the directory trees in the local computer forest. |
| RefreshSchemaCache |
Refreshes the ADSI Active Directory schema cache on the local computer. |
Properties
The IADsADSystemInfo interface has these properties.
| Property | Access type | Description |
|---|---|---|
|
Read-only |
Retrieves the distinguished name of the local computer. | |
|
Read-only |
Retrieves the DNS name of the local computer domain, for example "example.fabrikam.com". | |
|
Read-only |
Retrieves the short name of the local computer domain, for example "myDom". | |
|
Read-only |
Retrieves the DNS name of the local computer forest. | |
|
Read-only |
Determines whether the local computer domain is in native or mixed mode. | |
|
Read-only |
Retrieves the distinguished name of the NTDS-DSA object for the DC that owns the primary domain controller role in the local computer domain. | |
|
Read-only |
Retrieves the distinguished name of the NTDS-DSA object for the DC that owns the schema role in the local computer forest. | |
|
Read-only |
Retrieves the site name of the local computer. | |
|
Read-only |
Retrieves the Active Directory distinguished name of the current user, which is the logged-on user or the user impersonated by the calling thread. |
Requirements
|
Minimum supported client |
Windows Vista |
|---|---|
|
Minimum supported server |
Windows Server 2008 |
|
Header |
|
|
DLL |
|
|
IID |
IID_IADsADSystemInfo is defined as 5BB11929-AFD1-11D2-9CB9-0000F87A369E |
See also