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.
| Method | Description |
|---|---|
| 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.
| Property | Access type | Description |
|---|---|---|
|
Read-only |
Gets the object's ADsPath that uniquely identifies this object from all others. | |
|
Read-only |
Gets the name of the object's schema class. | |
|
Read/write |
Gets and sets the description of the group membership. | |
|
Read-only |
Gets the GUID of the object as stored in the underlying directory store. | |
|
Read-only |
Gets the object's relative name. | |
|
Read-only |
Gets the ADsPath string for the parent of the object. | |
|
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 Vista |
|---|---|
|
Minimum supported server |
Windows Server 2008 |
|
Header |
|
|
DLL |
|
|
IID |
IID_IADsGroup is defined as 27636B00-410F-11CF-B1FF-02608C9E7553 |
See also