CdbWorkspace::CreateUser Method

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

Syntax

CdbUserCreateUser(LPCTSTR pstrName=NULL,

LPCTSTR pstrPID=NULL,

LPCTSTR pstrPassword=NULL);

Parameters

Type Example Description
LPCTSTR pstrName Optional. A pointer to a string that uniquely names the new User object. See the Name property for details on valid User names.
LPCTSTR pstrPID Optional. A pointer to a string containing the personal identifier (PID) of a user account. The PID must contain from 4 to 20 alphanumeric characters. See the PID property for more information on valid personal identifiers.
LPCTSTR pstrPassword Optional. A pointer to a string containing the password for the new User object. The password can be up to 14 characters long and can include any characters except the ASCII character 0 (null). See the Password property for more information on valid passwords.

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