CreateGroup Method

See Also    Example    Applies To

Creates a new CdbGroup object (Microsoft Jet workspaces only).

Syntax

CdbGroupCreateGroup(LPCTSTR pstrName = NULL,

LPCTSTR pstrPID = NULL);

Parameters

Type Argument Description
LPCTSTR pstrName Optional. A pointer to a string that uniquely names the new CdbGroup object. See the Name property for details on valid CdbGroup names.
LPCTSTR pstrPID Optional. A pointer to a string containing the PID of a group account. The identifier must contain from 4 to 20 alphanumeric characters. See the PID property for more information on valid personal identifiers.

Remarks

You can use the CreateGroup method to create a new CdbGroup object for a CdbUser or CdbWorkspace. If you omit one or both of the optional parts when you use CreateGroup, you can use an appropriate assignment statement to set or reset the corresponding property before you append the new object to a collection. After you append the object, you can alter some but not all of its property settings. See the individual property topics for more details.

If pstrName refers to an object that is already a member of the collection, a run-time error occurs when you use the Append method.

To remove a CdbGroup object from a collection, use the Delete method on the Groups collection.

Usage

#include <afxole.h>
#include <dbdao.h>

CdbDBEngine       dben;
CdbWorkspace      ws;
CdbUser            usr;
CdbGroup         grp;
...   
ws = dben.Workspaces[0L];
usr = ws.CreateUser(_T("JohnDoe"), _T("Accountant"), _T("ACCT001")); 
grp = ws.CreateGroup(_T("Accountants"), _T("DEPT_01_99")); 
grp.Users.Append(usr);
usr.Groups.Append(grp);