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 (OS X) (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.
See Also
PvAlterUserName()
PvAddUserToGroup()
PvRemoveUserFromGroup()
PvCreateUser()
PvDropUser()
PvOpenDatabase()
PvCloseDatabase()