CdbrVersionable::GetPropertyValuesメソッド

機能

プロパティの取得(バージョン指定あり)

形式

// 全バージョン共有のプロパティを対象にする場合
DmaBoolean GetPropertyValues(
DmaInteger32           lPropDefListCount,
SDBR_PROPDEF*          pPropDefList,
SDBR_PROPLIST**        ppPropList )
 
// バージョンをバージョン識別子で指定する場合
DmaBoolean GetPropertyValues(
pDmaString_T           pVersionId,
DmaInteger32           lPropDefListCount,
SDBR_PROPDEF*          pPropDefList,
SDBR_PROPLIST**        ppPropList )
 
// プロパティ定義情報構造体
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;
};

詳細

オブジェクトのプロパティの値を取得するメソッドです。

バージョン識別子を指定しない場合,DMAオブジェクトのConfigurationHistoryオブジェクトに設定された,オブジェクト全体に対するプロパティが対象になります。

バージョン識別子を指定した場合は,バージョンごとの個別のプロパティが対象になります。バージョン識別子としてNULLを指定した場合は,カレントバージョンが対象になります。

引数

lPropDefListCount(入力)

pPropDefListに指定した配列の要素数を指定します。負の数を指定した場合は,エラーになります。

pPropDefList(入力)

取得するプロパティの定義情報である,SDBR_PROPDEF構造体の配列を指定します。なお,lPropDefListCountが正の整数のときにpPropDefListにNULLを指定すると,エラーになります。

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

ppPropList(出力)

取得したプロパティリスト構造体である,SDBR_PROPLIST構造体へのポインタが設定されます。ポインタを格納する領域を指定してください。*ppPropListがポイントする領域は,ライブラリが新たに確保したものです。この領域はメソッドをコールした側がdbrDelete関数を使用して解放してください。なお,プロパティがまったく取得されなかった場合は,NULLが設定されます。

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

pVersionId(入力)

対象となるバージョンのバージョン識別子を指定します。バージョン識別子はCdbrVersionable::GetVersionListメソッド,CdbrVersionable::GetVersionListAndLockメソッドまたはCdbrVersionable::VersionCheckOutメソッドで取得します。NULLを指定した場合は,カレントバージョンのプロパティを取得します。

戻り値

DMA_TRUE  正常終了

DMA_FALSE 異常終了

戻り値の詳細

major_codeminor_code説明対処
ERR_DBERR_DB_DEADLOCK_OCCURREDデータベースでデッドロックが発生しました。時間を置いて,再度実行してください。
ERR_DBERR_DB_FAILEDデータベースで障害が発生しました。syslogを参照して,障害の原因を取り除いてください。
ERR_DBERR_DB_LOCKEDオブジェクトがロックされています。時間を置いて,再度実行してください。
ERR_DBRERR_ACCESS_NOT_PERMITTEDアクセス権がありません。この操作は実行できません。
ERR_DBRERR_INVALID_STATUSセッションの状態が不正です。一つのセッションに同時に複数のメソッド処理要求が出されています。一つのセッションに対しては,一度に一つの処理要求しか出さないように見直してください。
ERR_DBRERR_OBJECT_ALREADY_CONNECTEDオブジェクトはすでに接続されています。この操作は実行できません。
ERR_DBRERR_OBJECT_REMOVEDオブジェクトはすでに削除されています。正しいオブジェクトを指定してください。
ERR_DBRERR_OIID_NOT_SETOIIDが設定されていません。SetOIIDメソッドをコールしてから,このメソッドをコールしてください。
ERR_DBRERR_SESSION_NOT_CONNECTセッションが接続されていません。セッションを接続してください。
ERR_DMADMARC_BAD_CLASSID指定された識別子は,利用できるオブジェクトのクラスではありません。正しいクラス識別子を指定してください。
ERR_DMADMARC_BAD_OIIDSetOIIDメソッドで設定されたOIIDが不正です。正しいOIIDを指定してください。
ERR_DMADMARC_BAD_PARAMETER不正な引数が入力されました。正しい引数を指定してください。
ERR_DMADMARC_BAD_PROPIDプロパティの識別子が不正です。正しいプロパティ識別子を指定してください。
ERR_DMADMARC_BAD_VALUEプロパティやリストの値が,許容範囲外の値であるかまたは最大値を超えました。値の範囲を見直してください。
ERR_DMADMARC_NO_MEMORYメモリ不足で実行できません。メモリを増設してください。またはメモリを大量に消費しているアプリケーションを停止させて,処理を再実行してください。
ERR_DMADMARC_NO_RESERVATIONバージョン識別子が予約されていません。チェックイン後に割り当てられる正式なバージョン識別子を,入力引数に設定してください。
ERR_DMADMARC_NOT_FOUND要求された要素が見つかりません。正しいオブジェクトを設定してください。
ERR_DMADMARC_NOT_SUPPORTEDこのセッションまたはオブジェクトではサポートされていないメソッドです。この操作は実行できません。
ERR_DMADMARC_READ_ONLY読み取り専用のオブジェクトまたはプロパティのため,異常終了しました。このプロパティの値は更新できません。
ERR_DMADMARC_UNEXPECTED予期しないエラーが発生しました。処理を終了してください。
ERR_DMADMARC_VALUE_NOT_SET要求されたプロパティは値を保持していません。この操作は実行できません。