Platform SDK: Active Directory, ADSI, and Directory Services

IADsDomain

The IADsDomain interface is designed for representing a network domain and for managing the accounts on the domain. This interface supports the functionality to examine whether the domain is actually a Workgroup, specify how frequent a user must change her password, and specify the maximum number of invalid password logins before lockout is set. To actually change a password, you must call the SetPassword method on an ADSI object supporting password controls. For example, to change the password of a user account, call IADsUser::SetPassword on the user object.

IADsDomain is a dual interface that inherits from IADs.

This interface exposes the following properties and methods.

Methods in Vtable Order

IUnknown methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements reference count.

IDispatch methods Description
GetTypeInfoCount Gets the number of type descriptions.
GetTypeInfo Gets a description of object's programmable interface.
GetIDsOfNames Maps name of method or property to DISPID.
Invoke Calls one of the object's methods, or gets and sets one of its properties.

IADsDomain property methods Description
IsWorkgroup Checks if the domain is actually a workstation that is a member of a workgroup.
MinPasswordLength Gets and sets minimum number of characters required.
MinPasswordAge Gets and sets minimum age before allowing a password change.
MaxPasswordAge Gets and sets age at which password must be changed.
MaxBadPasswordsAllowed Gets and sets maximum bad password logins before lockout.
PasswordHistoryLength Gets and sets number of passwords saved.
PasswordAttributes Gets and sets password restrictions.
AutoUnlockInterval Gets and sets the minimum time that can elapse before an account is automatically re-enabled.
LockoutObservationInterval Gets and sets time window for monitoring account.

Remarks

For the WinNT provider supplied by Microsoft®, this interface is implemented on the WinNTDomain object.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with DSClient).
  Windows 95/98: Requires Windows 95 or later (with DSClient).
  Header: Declared in Iads.h.

See Also

IADsDomain Property Methods, IADsUser::SetPassword, IADs