9.2.1 IADsGroup

The IADsGroup interface is used to get and set the properties of the Group object. The interface definition is as follows:

[ object, uuid(IID_IADsGroup), oleautomation, dual ]

interface IADsGroup: IADs

{

// Read/write properties.

[propget]

HRESULT Description ([out, retval]BSTR *pbstrDescription);

[propput]

HRESULT Description ([out, retval]BSTR bstrDescription);

// methods

HRESULT Members ([out, retval]IADsMembers **ppMembers);

HRESULT IsMember([in]BSTR bstrAdsPathMember,

[out, retval]boolean *bMember);

HRESULT Add([in]BSTR bstrNewItem);

HRESULT Remove([in]BSTR bstrItemToBeRemoved);

};

Method

Syntax

Description

Description

String

Gets and sets the text description of the group.

Members

Method

Returns a collection of Active Directory objects that represent the members of this group.

IsMember

Method

Returns TRUE if the component whose ADS Path is given is a member of this group. Providers might support recursive membership checks if a group is allowed to have other groups as members.

Add

Method

Adds the given member to the group. "bstrNewItem" is the ADsPath of the object to add to the group (usually a user or another group, this is provider specific).

Remove

Method

Removes the item specified by bstrItemToBeRemoved. This removes the given ADsPath from the collection, it does not affect the object pointed to by the path. ..