PreviousDTI Programmer's Guide (v10) Next

PvAddUserToGroup()

Chapter contents

Adds an existing user to an existing group in the database.

Header file: DDF.H
Requires: W3DBAV90.DLL

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
group
Database group name
In
user
Database user 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:

The following post condition must be met:

See Also

PvAlterUserName()
PvCreateGroup()
PvCreateUser()
PvDropGroup()
PvDropUser()
PvRemoveUserFromGroup()
PvOpenDatabase()
PvCloseDatabase()


Chapter contents
Book contents

Prev topic: PvAddTable()
Next topic: PvAlterUserName()