CdbrDMA::GetOIIDメソッド
機能
OIIDの取得
形式
DmaBoolean GetOIID(
ppDmaString_T ppOIID)
詳細
オブジェクトのOIIDを取得するメソッドです。ここで取得するOIIDの実体は,対応するDMAオブジェクトのOIIDです。
ppOIIDに,OIID文字列へのポインタが設定されます。この文字列領域はオブジェクト内に確保されて,オブジェクトの消滅とともに破棄されます。したがって,メソッドをコールした側が破棄する必要はありません。オブジェクトの消滅以降もこの値を使用したい場合は,必ず内容をほかの領域に複写するようにしてください。
引数
ppOIID(出力)
OIID文字列へのポインタが設定されます。OIIDが特定できない場合,NULLが設定されます。
戻り値
DMA_TRUE 正常終了
DMA_FALSE 異常終了
戻り値の詳細
major_code | minor_code | 説明 | 対処 |
---|---|---|---|
ERR_DBR | ERR_INVALID_STATUS | セッションの状態が不正です。一つのセッションに同時に複数のメソッド処理要求が出されています。 | 一つのセッションに対しては,一度に一つの処理要求しか出さないように見直してください。 |
ERR_DBR | ERR_OBJECT_ALREADY_CONNECTED | オブジェクトはすでに接続されています。 | この操作は実行できません。 |
ERR_DBR | ERR_SESSION_NOT_CONNECT | セッションが接続されていません。 | セッションを接続してください。 |
ERR_DMA | DMARC_BAD_PARAMETER | 不正な引数が入力されました。 | 正しい引数を指定してください。 |
ERR_DMA | DMARC_UNEXPECTED | 予期しないエラーが発生しました。 | 処理を終了してください。 |