Distributed Tuning Interface Reference : PvAddUserToGroup()
 
PvAddUserToGroup()
Adds an existing user to an existing group in the database.
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 PvAddUserToGroup(
   BTI_WORD            dbHandle,
   const BTI_CHAR*     user,
   const BTI_CHAR*     group);
Arguments
 
In
dbHandle
Handle of an open database returned by PvOpenDatabase().
In
user
Database user name
In
group
Database group name
Return Values
 
PCM_Success
The operation was successful.
PCM_errFailed
The operation was not successful.
PCM_errInvalidAccountName
The specified account or user name does not exist.
PCM_errUserAlreadyPartOfGroup
User already part of the group.
PCM_errDatabaseHasNoSecurity
Database has no security.
PCM_errSessionSecurityError
Database opened with insufficient privilege.
Remarks
This function will fail if the specified group or user do not already exist in the database, or if the user is a member of another group.
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.
The user and group already exist in the specified database.
The user is not a member of another group.
The following post condition must be met:
Use PvCloseDatabase() to free the resources.
See Also
PvAlterUserName()
PvCreateGroup()
PvCreateUser()
PvDropGroup()
PvDropUser()
PvRemoveUserFromGroup()
PvOpenDatabase()
PvCloseDatabase()