Interstage Shunsaku Data Manager Application Development Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

11.1 C API Overview

The C APIs are interfaces used to manipulate Shunsaku data from applications written in C.

Applications that use C APIs create a connection handle to connect to Shunsaku and then create a data manipulation handle to perform searches and updates.

The following diagram provides an overview of the C APIs.

[Figure 11-1 Overview of C APIs]

As the above diagram indicates, there are two types of C API handle: The connection handle and the data manipulation handle.

[Table 11-1 C API Handles]

Handle	Overview	Creation lifetime
Connection handle	Opens and closes connections.	Created for each connection.
Data manipulation handle	Performs data searches and updates and retains search results	Created for each data manipulation.

The two types of handle are in a parent-child relationship. Data manipulation handles are allocated on the basis of a connection handle. When a connection handle is released, the data manipulation handle(s) will also be released.

[Figure 11-2 Relationship between Connection Handles and Data Manipulation Handles]

---

11.1.1 Using Handle

11.1.2 Connection Handles

11.1.3 Data Manipulation Handles

11.1.4 Common Functions