PvCreateUser()

PvCreateUser()

Creates a new user in the existing database. Optionally set a password and assign the new user to an existing group.

Header File: ddf.h (See also Header Files)

Function First Available In Library: w3dbav90.dll (Windows), libpsqldti.so (Linux), libpsqldti.dylib (macOS) (See also Link Libraries)

Syntax

PRESULT DDFAPICALLTYPE PvCreateUser(

BTI_WORD dbHandle,

const BTI_CHAR* user,

const BTI_CHAR* password,

const BTI_CHAR* group);

Arguments

In	dbHandle	Handle of an open database returned by PvOpenDatabase().
In	user	Database user name.
In	password	User password. If set to NULL, no password is set.
In	group	Database group name for user. If set to NULL, user is not assigned to a group.

Return Values

PCM_Success	The operation was successful.
PCM_errFailed	The operation was not successful.
PCM_errInvalidAccountName	The specified account or user name is invalid.
PCM_errUserAlreadyExists	User already exists.
PCM_errDatabaseHasNoSecurity	Database has no security.
PCM_errSessionSecurityError	Database opened with insufficient privilege.

Remarks

The following preconditions must be met:

•You must first open a database successfully using PvOpenDatabase() as user 'Master'.

•The associated database has database-level security enabled.

•A user with the same name cannot already exist in the specified database.

The following post condition must be met:

•Use PvCloseDatabase() to free the resources.