uCosminexus DocumentBroker Version 3 クラスライブラリ C++ リファレンス 基本機能編

[目次][用語][索引][前へ][次へ]

CdbrXmlTranslatorFactory::CreateTranslatorメソッド

機能

CdbrXmlTranslatorオブジェクトの生成

形式

DmaBoolean CreateTranslator(
  CdbrXmlTranslator*    pXmlTrans)

詳細

CdbrXmlTranslatorオブジェクトを生成し,指定された領域に格納するメソッドです。CdbrXmlTranslatorFactory::Initializeメソッドを実行する前にこのメソッドを実行すると,CdbrXmlTranslatorFactoryオブジェクトが未初期化状態のためエラーになります。

生成したCdbrXmlTranslatorオブジェクトは,CdbrXmlTranslatorFactoryオブジェクトが破棄されるまで有効です。CdbrXmlTranslatorFactoryオブジェクトが破棄されるとCdbrXmlTranslatorオブジェクトは無効状態となり,CdbrXmlTranslatorクラスの主要なメソッドは実行時にエラーになります。

また,生成したCdbrXmlTranslatorオブジェクトは,生成時と異なるスレッド上では使用できません。

引数

pXmlTrans(出力)

生成されたCdbrXmlTranslatorオブジェクト(CdbrXmlTranslator型の変数)が設定されます。生成されたオブジェクトを格納する領域のアドレスを指定してください。領域はユーザ側で確保してください。NULLを指定するとエラーになります。指定した領域にCdbrXmlTranslatorオブジェクトがすでに格納されている場合,そのオブジェクトは破棄されます。

戻り値

DMA_TRUE  正常終了

DMA_FALSE 異常終了

戻り値の詳細

major_code minor_code 説明 対処
ERR_DBR ERR_OBJECT_NOT_INITIALIZE オブジェクトが初期化されていません。 初期化を実行してください。
ERR_DMA DMARC_BAD_PARAMETER 不正な引数が入力されました。 正しい引数を指定してください。
ERR_DMA DMARC_NO_MEMORY メモリ不足で実行できません。 メモリを増設してください。またはメモリを大量に消費しているアプリケーションを停止させて,処理を再実行してください。
ERR_DMA DMARC_UNEXPECTED 予期しないエラーが発生しました。 処理を終了してください。