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);