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 | 予期しないエラーが発生しました。 | 処理を終了してください。 |