PvAlterUserName()

Alters an existing user's name in the specified database.

Header file: DDF.HRequires: W3DBAV90.DLL

PRESULT DDFAPICALLTYPE PvAlterUserName( 
	BTI_WORD            dbHandle, 
	const BTI_CHAR*     user, 
	const BTI_CHAR*     newName);


In	dbHandle	Handle of an open database returned by PvOpenDatabase().
In	user	Database user name.
In	newName	New name for the database user. If set to NULL, the function fails.


PCM_Success	The operation was successful.
PCM_errFailed	The operation was not successful.
PCM_errInvalidAccountName	The specified account or user name does not exist, or the new name is invalid.
PCM_errUserAlreadyExists	New user name already exists.
PCM_errDatabaseHasNoSecurity	Database has no security.
PCM_errSessionSecurityError	Database opened with insufficient privilege.

This function will fail if newName is set to NULL, or if newName is already present in the database.

The following preconditions must be met:

You must first open a dictionary successfully using PvOpenDatabase() as user 'Master'.

The associated database has database-level security enabled.

The user name must already exist in the specified database.

The new user name cannot already exist in the specified database.

The following post condition must be met:

Use PvCloseDatabase() to free the resources.