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