PvAlterUserPassword()

Alters an existing user's password.

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 PvAlterUserPassword(

BTI_WORD dbHandle,

const BTI_CHAR* user,

const BTI_CHAR* newPassword);

Arguments

In	dbHandle	Handle of an open database returned by PvOpenDatabase().
In	user	Database user name.
In	newPassword	New user password. If set to NULL, the password is cleared.

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_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.

•The user name must already exist in the specified database.

The following post condition must be met:

•Use PvCloseDatabase() to free the resources.