開発者リファレンス : プラットフォーム管理 : Distributed Tuning Interface (DTI) Guide : Distributed Tuning Interface のリファレンス : PvCreateUser()
 
このページをシェアする                  
PvCreateUser()
既存のデータベースに新しいユーザーを作成します。オプションとして、パスワードを設定することと新しいユーザーを既存のグループに割り当てることができます。
ヘッダー ファイル:ddf.h(ヘッダー ファイルも参照)
関数が最初に利用可能になるライブラリ:w3dbav90.dll(Windows)、libpsqldti.so(Linux)、libpsqldti.dylib(macOS)(リンク ライブラリも参照)
構文
PRESULT DDFAPICALLTYPE PvCreateUser(
   BTI_WORD            dbHandle,
   const BTI_CHAR*     user,
   const BTI_CHAR*     password,
   const BTI_CHAR*     group);
引数
 
In
dbHandle
PvOpenDatabase() によって返される、開いている辞書のハンドル。
In
user
データベース ユーザー名。
In
password
ユーザー パスワード。ヌルを設定するとパスワードは設定されません。
In
group
ユーザーのデータベース グループ名。ヌルを設定するとユーザーはグループに割り当てられません。
戻り値
 
PCM_Success
操作は成功しました。
PCM_errFailed
操作は成功しませんでした。
PCM_errInvalidAccountName
指定されたアカウントまたはユーザー名が無効です。
PCM_errUserAlreadyExists
ユーザーは既に存在します。
PCM_errDatabaseHasNoSecurity
データベースにはセキュリティが設定されていません。
PCM_errSessionSecurityError
不十分な権限でデータベースが開かれました。
備考
以下の前提条件を満たす必要があります。
まず "Master" ユーザーとして PvOpenDatabase() を使用し、データベースを正常に開いておく。
関連するデータベースはデータベース レベルのセキュリティが有効である。
同じ名前のユーザーが指定したデータベースに存在していない。
次の事後条件を満たす必要があります。
PvCloseDatabase() を使用してリソースを解放する。
関連項目
PvAlterUserName()
PvAlterUserPassword()
PvAddUserToGroup()
PvRemoveUserFromGroup()
PvCreateGroup()
PvDropUser()
PvOpenDatabase()
PvCloseDatabase()