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:
See Also