Represents a database API. The point you have to start with. More...
|SAPI (bool unloadAPI=false)|
|Defaut constructor. |
|SAPI (SAClient_t eSAClient, bool unloadAPI=false) SQLAPI_THROW(SAException)|
|Initializes the object with specific DBMS API type. |
|A destructor. More...|
|void||setClient (SAClient_t eSAClient) SQLAPI_THROW(SAException)|
|Assigns an DBMS client for the API class. More...|
|SAClient_t||Client () const|
|Returns the current DBMS client assigned for the connection. |
|long||ClientVersion () const SQLAPI_THROW(SAException)|
|Returns the DBMS client API version number. More...|
|IsaAPI *||NativeAPI () const SQLAPI_THROW(SAException)|
|Returns a native DBMS client API object. More...|
|bool||isUnloadAPI () const|
|Returns native API unload flag value. |
|Public Member Functions inherited from SAOptions|
|Defaut constructor. |
|virtual SAString &||setOption (const SAString &sOptionName)|
|Sets a string value of a specific option. More...|
|virtual SAString||Option (const SAString &sOptionName) const|
|Returns a string value of a specific option. |
|virtual int||TotalOptions () const|
|Returns the count of options. |
|virtual SAString||OptionName (int nIndex) const|
|Returns the string value of an option. |
Represents a database API. The point you have to start with.
The SAPI class represents a database API. You may need to have a DBMS API initialized before you can operate on the database - furthermore the SAConnection needs to be connected. It is important to note that DBMS API objects are not initialized during construction - it is up to the user to explicitly call SAPI::setClient method for the object after it is created and before it is used. DBMS API connection object is normally shared by the other objects those require a DBMS aceccing (e.g. SAConnection object).
Implicitly closes and deassosiates all linked SAConnection.
Uninitializes DBMC API library.
Assigns an DBMS client for the API class.
|eSAClient||One of the following values from SAClient_t enum.|
Returns the DBMS client API version number.
|IsaAPI * SAPI::NativeAPI||(||)||const|
Returns a native DBMS client API object.
See Server Specific Guide section to know what type cast you have to make and what additional header file you have to include to work with specific DBMS client API. Note that for some DBMS using appropriate type casting depends on an API version (that generally mean that you have to explicitly check client version before casting, see SAPI::ClientVersion method).
To get more information about DBMS API functions see this DBMS specific documentation.
Please be aware of the complications associated with making direct API calls, as the internal logic of the SQLAPI++ Library is not used. Besides, making direct API calls reduces an application's portability.