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.