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