Distributed Tuning Interface Guide (v11)

PvAlterUserName() (DTI 関数)

指定されたデータベースの既存のユーザーの名前を変更します。

ヘッダー ファイル:ddf.h(「ヘッダー ファイル」も参照)

関数が最初に利用可能になるライブラリ:w3dbav90.dll(Windows)、libpsqldti.so(Linux)(「リンク ライブラリ」も参照)

構文

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

引数

In
dbHandle
PvOpenDatabase() (DTI 関数)によって返される、開いている辞書のハンドル。
In
user
データベース ユーザー名。
In
newName
データベース ユーザーの新しい名前。ヌルを設定すると関数は失敗します。

戻り値

PCM_Success
操作は成功しました。
PCM_errFailed
操作は成功しませんでした。
PCM_errInvalidAccountName
指定されたアカウントまたはユーザー名が存在しないか、新しい名前が無効です。
PCM_errUserAlreadyExists
新しいユーザー名は既に存在します。
PCM_errDatabaseHasNoSecurity
データベースにはセキュリティが設定されていません。
PCM_errSessionSecurityError
不十分な権限でデータベースが開かれました。

備考

この関数は、newName にヌルが設定されていたり newName が既にデータベースに存在すると失敗します。

以下の前提条件を満たす必要があります。

次の事後条件を満たす必要があります。

関連項目

PvAlterUserPassword() (DTI 関数)
PvAddUserToGroup() (DTI 関数)
PvRemoveUserFromGroup() (DTI 関数)
PvCreateUser() (DTI 関数)
PvDropUser() (DTI 関数)
PvOpenDatabase() (DTI 関数)
PvCloseDatabase() (DTI 関数)


PvAddUserToGroup() (DTI 関数)

PvAlterUserPassword() (DTI 関数)