バージョン管理情報一覧の取得と同時に指定したロックの設定

// バージョン識別子なしで取得する場合
DmaBoolean GetVersionableListAndLock(
  pDmaBoolean           pbContinue,
  DmaInteger32          lPropDefListCount,
  SDBR_PROPDEF*         pPropDefList,
  DmaInteger32          lObjListCount,
  SDBR_OBJLIST**        ppObjList,
  DmaInteger32          lLockType = DMA_LOCK_WRITE)
　
// バージョン識別子付きで取得する場合
DmaBoolean GetVersionableListAndLock(
  pDmaBoolean           pbContinue,
  DmaInteger32          lPropDefListCount,
  SDBR_PROPDEF*         pPropDefList,
  DmaInteger32          lObjListCount,
  SDBR_VROBJLIST**      ppVrObjList,
  DmaInteger32          lLockType = DMA_LOCK_WRITE)
　
// プロパティ定義情報構造体
struct SDBR_PROPDEF {
    DmaId            PropId;              // プロパティ識別子
};
　
// プロパティ構造体
struct SDBR_PROP {
  DmaId              PropId;              // プロパティ識別子
  DmaInteger32       lType;               // データ型
  DmaInteger32       lCardinality;        // 基本単位
  DmaInteger32       lCount;              // 要素数
  union {                                 // プロパティの値
    pDmaBoolean      pbBoolean;           // Boolean型
    pDmaInteger32    plInteger32;         // Integer32型
    pDmaId           pId;                 // ID型
    pDmapv           ppObject;            // Object型
    ppDmaString_T    ppString;            // String型
  } uniValue;
};
 
// プロパティリスト構造体
struct SDBR_PROPLIST {
    DmaInteger32      lCount;
    SDBR_PROP*        pItem;
};
　
// オブジェクト情報構造体
struct SDBR_OBJINFO {
    pDmaString_T       pOIID;         // オブジェクトのOIID
    DmaInteger32       lType;         // オブジェクトの種別
    SDBR_PROPLIST      PropList;      // プロパティリスト構造体
};
　
// オブジェクトリスト構造体
struct SDBR_OBJLIST {
    DmaInteger32      lCount;
    SDBR_OBJINFO*     pItem;
};
　
// バージョン識別子付きオブジェクト情報構造体
struct SDBR_VROBJINFO {
    pDmaString_T       pOIID;         // オブジェクトのOIID
    DmaInteger32       lType;         // オブジェクトの種別
    pDmaString_T       pVersionId;    // バージョン識別子
    SDBR_PROPLIST      PropList;      // プロパティリスト構造体
};
　
// バージョン識別子付きオブジェクトリスト構造体
struct SDBR_VROBJLIST {
    DmaInteger32      lCount;
    SDBR_VROBJINFO*   pItem;
};

ロックタイプを明示的に指定して，CdbrVersionTraceableContainerオブジェクトを包含しているCdbrConfiguratedReferentialContainerオブジェクトの一覧を取得するメソッドです。このオブジェクトを表すバージョン識別子も同時に取得できます。また，pPropDefListで指定したプロパティを持つオブジェクトについては，そのプロパティ値も取得します。ただし，このオブジェクトが仮のバージョンに該当するオブジェクトの場合は，CdbrConfiguratedReferentialContainerオブジェクトを取得できません。

1回のメソッドのコールですべての要素の取得が完了しなかった場合，*pbContinueにDMA_TRUEが設定されるので，再度メソッドをコールして残りを取得してください。

複数回に分けて情報を取得する場合，取得される内容はすべて，１回目のメソッドのコール時点の状態に依存します。したがって，１回目のメソッドのコール以降に変更した要素数やプロパティ値は，２回目以降のコールに反映されません。

また，要素の個数に変更がなく，同じオブジェクトに対するメソッドのコールであっても，取得される情報の順序は常に異なる可能性があります。

このメソッドの使用方法については，「5.　CdbrContainableクラス（包含要素を扱うクラス）」のCdbrContainable::GetContainerListメソッドを参照してください。

pbContinue（入力／出力）

リストの取得方法を示す値を格納する領域を指定します。

DMA_TRUEを指定すると，オブジェクトに対する前回のメソッドのコールで取得した要素の次の要素から取得します。DMA_FALSEまたはDMA_UNKNOWNを指定すると，前回取得の残りを破棄して，新たに先頭から取得します。なお，オブジェクトの作成後初めてメソッドをコールした場合または前回の読み出しですべて取得した場合は，DMA_FALSEを指定したものとして処理されます。

また，前回実行したときと引数が異なるメソッドが実行された場合は，pbContinueの値を無視して，新たに先頭から取得します。

正常終了すると，メソッドを継続してコールする必要があるかどうかを示す値が設定されます。リストの呼び出しがすべて完了した場合はDMA_FALSEが設定されます。まだ取得されていない要素がある場合はDMA_TRUEが設定されます。

2回目以降に取得する場合に，DMA_TRUEを指定した場合とDMA_FALSEを指定した場合の，ほかの引数に指定した値の扱われ方について，次に示します。

表17-4　ほかの引数の扱われ方（SDBR_OBJLIST構造体を取得する場合）

ほかの引数	pbContinueの値
	DMA_TRUE	DMA_FALSE
lPropDefListCount	×	○
pPropDefList	×	○
lObjListCount	○	○
ppObjList	○	○
ppVrObjList	○	○
lLockType	×	○

（凡例）

○：有効

×：無効

lPropDefListCount（入力）

pPropDefListの要素数を指定します。0を指定した場合，pPropDefListの内容は無視され，プロパティの取得されません。負の値を指定した場合は，エラーになります。

pPropDefList（入力）

同時に取得するプロパティの定義情報である，SDBR_PROPDEF構造体の配列を指定します。

プロパティを取得しない場合はNULLを指定します。なお，lPropDefListCountが正の整数のときにpPropDefListにNULLを指定した場合は，エラーになります。

SDBR_PROPDEF構造体に指定する内容については，「付録C.1(13)　SDBR_PROPDEF構造体（プロパティ定義情報構造体）」を参照してください。

lObjListCount（入力）

取得する情報の個数を指定します。0以下の数を指定するとエラーになります。

ppObjList（出力）

取得した情報を格納するオブジェクト情報リスト構造体である，SDBR_OBJLIST構造体へのポインタが設定されます。*ppObjListがポイントするメモリは，ライブラリが新たに確保したものです。このメモリは，ユーザプログラムでdbrDelete関数を使用して解放してください。なお，*ppObjListを指定したメモリ解放によって，構造体のメンバ(*ppObjList)->pItemおよびその先に確保されているメモリはすべて解放されます。したがって，メソッドをコールした側は，これらのメンバのメモリを個別に解放する必要はありません。

SDBR_OBJLIST構造体およびSDBR_OBJINFO構造体に設定される内容については，「付録C.1(9)　SDBR_OBJLIST構造体（オブジェクトリスト構造体）」および「付録C.1(8)　SDBR_OBJINFO構造体（オブジェクト情報構造体）」を参照してください。

また，プロパティ情報が設定されるSDBR_PROPLIST構造体およびSDBR_PROP構造体については，「付録C.1(14)　SDBR_PROPLIST構造体（プロパティリスト構造体）」および「付録C.1(12)　SDBR_PROP構造体（プロパティ構造体）」を参照してください。

ppVrObjList（出力）

取得した情報を格納するバージョン識別子付きオブジェクト情報リスト構造体である，SDBR_VROBJLIST構造体へのポインタが設定されます。*ppVrObjListがポイントするメモリは，ライブラリが新たに確保したものです。このメモリは，ユーザプログラムでdbrDelete関数を使用して解放してください。なお，*ppVrObjListを指定したメモリ解放によって，構造体のメンバ(*ppVrObjList)->pItemおよびその先に確保されているメモリはすべて解放されます。したがって，メソッドをコールした側は，これらのメンバのメモリを個別に解放する必要はありません。

SDBR_VROBJLIST構造体およびSDBR_VROBJINFO構造体に設定される内容については，「付録C.1(22)　SDBR_VROBJLIST構造体（バージョン識別子付きオブジェクトリスト構造体）」および「付録C.1(21)　SDBR_VROBJINFO構造体（バージョン識別子付きオブジェクト情報構造体）」を参照してください。

また，プロパティ情報が設定されるSDBR_PROPLIST構造体およびSDBR_PROP構造体については，「付録C.1(14)　SDBR_PROPLIST構造体（プロパティリスト構造体）」および「付録C.1(12)　SDBR_PROP構造体（プロパティ構造体）」を参照してください。

lLockType（入力）

ロックの種別を指定します。次の値のどれかを設定します。

• DMA_LOCK_READ
  readロックを設定します。readロックを設定すると，ほかのクライアントからwriteロックを設定できません。ロックがすでに設定されている場合には，ロックが解除されるまで待ちます。
  
• DMA_LOCK_WRITE
  排他的なwriteロックを設定します。排他的なwriteロックを設定すると，ほかのクライアントからreadロックおよびwriteロックを設定できません。ロックがすでに設定されている場合には，ロックが解除されるまで待ちます。
  
• DMA_LOCK_READ | DBR_RLT_FOR_UPDATE
  readロックを設定し，更新・削除用の一覧を取得します。readロックを設定すると，ほかのクライアントからwriteロックを設定できません。ロックがすでに設定されている場合には，ロックが解除されるまで待ちます。
  このロック種別は，一覧を分割取得する場合に，取得した一覧のオブジェクトに対して，更新・削除処理を実行するときに指定してください。
  
• DMA_LOCK_WRITE | DBR_RLT_FOR_UPDATE
  排他的なwriteロックを設定し，更新・削除用の一覧を取得します。排他的なwriteロックを設定すると，ほかのクライアントからreadロックおよびwriteロックを設定できません。ロックがすでに設定されている場合には，ロックが解除されるまで待ちます。
  このロック種別は，一覧を分割取得する場合に，取得した一覧のオブジェクトに対して，更新・削除処理を実行するときに指定してください。
  

DMA_TRUE　 正常終了

DMA_FALSE　異常終了

major_code	minor_code	説明	対処
ERR_CORBA	CORBAの戻り値が設定されます。	CORBAでエラーが発生しました。	ユーザプログラムでは対処できません。エラー情報として文字列の値を取得して，ユーザプログラムを終了してください。
ERR_DB	ERR_DB_DEADLOCK_OCCURRED	データベースでデッドロックが発生しました。	時間を置いて，再度実行してください。
ERR_DB	ERR_DB_FAILED	データベースで障害が発生しました。	syslogを参照して，障害の原因を取り除いてください。
ERR_DB	ERR_DB_LOCKED	オブジェクトがロックされています。	時間を置いて，再度実行してください。
ERR_DBR	ERR_ACCESS_NOT_PERMITTED	アクセス権がありません。	この操作は実行できません。
ERR_DBR	ERR_ACLIB_OBJECT_INVALID	クラスライブラリのオブジェクトは無効です。	有効なクラスライブラリのオブジェクトを指定してください。
ERR_DBR	ERR_INVALID_STATUS	セッションの状態が不正です。一つのセッションに同時に複数のメソッド処理要求が出されています。	一つのセッションに対しては，一度に一つの処理要求しか出さないように見直してください。
ERR_DBR	ERR_OBJECT_REMOVED	オブジェクトはすでに削除されています。	正しいオブジェクトを指定してください。
ERR_DBR	ERR_OIID_NOT_SET	OIIDが設定されていません。	SetOIIDメソッドをコールしてから，このメソッドをコールしてください。
ERR_DBR	ERR_SESSION_NOT_CONNECT	セッションが接続されていません。	セッションを接続してください。
ERR_DMA	DMARC_BAD_LOCK_TYPE	不正な種類のロックが指定されています。	正しいロックタイプを指定してください。
ERR_DMA	DMARC_BAD_OIID	SetOIIDメソッドで設定されたOIIDが不正です。	正しいOIIDを指定してください。
ERR_DMA	DMARC_BAD_PARAMETER	不正な引数が入力されました。	正しい引数を指定してください。
ERR_DMA	DMARC_BAD_PROPID	プロパティの識別子が不正です。	正しいプロパティ識別子を指定してください。
ERR_DMA	DMARC_FAILED	操作が失敗しました。	時間を置いて再度実行するか，処理を見直してください。
ERR_DMA	DMARC_LOST_CONNECTION	現在のオブジェクトからデータベースへの論理的な接続が失われました。操作は完了できません。	文書空間に再接続してください。
ERR_DMA	DMARC_NO_MEMORY	メモリ不足で実行できません。	メモリを増設してください。またはメモリを大量に消費しているアプリケーションを停止させて，処理を再実行してください。
ERR_DMA	DMARC_NOT_FOUND	要求された要素が見つかりません。	正しいオブジェクトを設定してください。
ERR_DMA	DMARC_NOT_SUPPORTED	このセッションまたはオブジェクトではサポートされていないメソッドです。	この操作は実行できません。
ERR_DMA	DMARC_UNEXPECTED	予期しないエラーが発生しました。	処理を終了してください。
ERR_DMA	EDMRC_NOT_INTRANSACTION	トランザクション外でメソッドが呼ばれました。	Beginメソッドの呼び出し後に，この操作を実行してください。