Developer Reference : Platform Management : Distributed Tuning Interface (DTI) Guide : Distributed Tuning Interface Reference : 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.
See Also
PvAlterUserName()
PvAlterUserPassword()
PvAddUserToGroup()
PvRemoveUserFromGroup()
PvCreateGroup()
PvDropUser()
PvOpenDatabase()
PvCloseDatabase()