Interstage Shunsaku Data Manager アプリケーション開発ガイド - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX共通 -

11.2.3.1 データを追加する

データを追加するには、ShunInsert関数を利用します。

データを追加する場合の流れについて、以下の図に示します。

[図:データを追加する場合の流れ]

■記述例

SHUNHSTMT StmtH;
/* データ操作ハンドルの割当て */
ShunAllocHandle(ConH, &StmtH);                             (1)

/* XML文書の追加 */
SHUNDATA Data[1];
Data[0].Data =
  "<document>"
  "    <base>"
         :
  "    </base>"
  "    <information>"
         :
  "    </information>"
  "</document>";
Data[0].Data_Len = strlen( Data[0].Data );
ShunInsert(StmtH, 1, Data);                                (2)

/* データ操作ハンドル解放 */
ShunFreeHandle(StmtH);                                     (3)

◆(1) データ操作ハンドルの割当て

事前にデータ操作ハンドルを割り当てします。データ操作ハンドルは、ShunAllocHandle関数に、親ハンドルとなるコネクションハンドルを指定して割り当てます。

◆(2) XML文書の追加

ShunInsert関数に、データ操作ハンドル、追加するデータ件数、追加するXML文書を指定し、追加します。

ShunInsert関数では、一度に複数のXML文書を追加することができます。次のいずれの形式も指定できます。

• 1つの追加データ領域に複数のXML形式の文書を連続して記述する。
• 複数の追加データ領域を指定する。

◆(3) データ操作ハンドルの解放

データの追加が完了したら、ShunFreeHandle関数でデータ操作ハンドルを解放します。