IADsGroup interface

The IADsGroup interface is a dual interface that inherits from IADs. It manages group membership data in a directory service. It enables you to get member objects, test if a given object belongs to the group, and to add, or remove, an object to, or from, the group.

Members

The IADsGroup interface inherits from IDispatch and IADs. IADsGroup also has these types of members:

Methods

The IADsGroup interface has these methods.

MethodDescription
Add

Adds an object to a group.

Get

Gets the value for a property by name.

GetEx

Gets the value for a single or multi-valued property by name.

GetInfo

Loads the property values of this object from the underlying directory store.

GetInfoEx

Loads specific property values of this object from the underlying directory store.

IsMember

Verifies membership.

Members

Gets an IADsMembers interface on the members object that is the collection of ADSI objects that represent the members of this group.

Put

Sets the value for a property by name.

PutEx

Sets the value for a single or multi-valued property by name.

Remove

Removes an object from a group.

SetInfo

Persists the changes on this object to the underlying directory store.

 

Properties

The IADsGroup interface has these properties.

PropertyAccess typeDescription

AdsPath

Read-only

Gets the object's ADsPath that uniquely identifies this object from all others.

Class

Read-only

Gets the name of the object's schema class.

Description

Read/write

Gets and sets the description of the group membership.

GUID

Read-only

Gets the GUID of the object as stored in the underlying directory store.

Name

Read-only

Gets the object's relative name.

Parent

Read-only

Gets the ADsPath string for the parent of the object.

Schema

Read-only

Gets the ADsPath string to the schema class object for this object.

 

Examples

The following code example shows how to bind to the Power Users group using the WinNT provider.

Dim group As IADsGroup
Set group = GetObject("WinNT://Fabrikam/Power Users")

The following code example works with the LDAP provider:

Dim group As IADsGroup
Set group = GetObject("LDAP://CN=Power Users,DC=Fabrikam,DC=com")

The following code example binds to the Power Users group through the WinNT provider.


IADsGroup *pGroup;
HRESULT hr;
LPWSTR adsPath = L"WinNT://Fabrikam/Power Users";

hr = ADsGetObject(adsPath,IID_IADsGroup,(void**)&pGroup);

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Iads.h

DLL

Activeds.dll

IID

IID_IADsGroup is defined as 27636B00-410F-11CF-B1FF-02608C9E7553

See also

IADs
IADsGroup Property Methods

 

 

Show:
© 2014 Microsoft. All rights reserved.