Oracle® Call Interface Programmer's Guide, 10g Release 2 (10.2) Part Number B14250-02 |
|
|
View PDF |
This section describes the XML DB functions.
Table 22-3 XML DB Functions
Function/Page | Purpose |
---|---|
|
Free an XML context. |
|
Initialize an XML context for XML data from the database. |
Purpose
Free any allocations made by the call to OCIXmlDbInitXmlCtx()
.
Syntax
void OCIXmlDbFreeXmlCtx ( xmlct *xctx );
Parameters
The XML context to terminate.
Comments
None.
Related Functions
Purpose
To initialize an XML context for XML data from the database.
Syntax
xmlctx *OCIXmlDbInitXmlCtx ( OCIEnv *envhp, OCISvcCtx *svchp, OCIError *errhp, ocixmldbparam *params, ub4 num_params );
Parameters
The OCI environment handle.
The OCI service handle.
The OCI error handle.
The optional possible values in this array are pointers to:
The OCI duration. Default value is OCI_DURATION_SESSION
.
An error handler which is a user-registered callback of prototype:
void (*err_handler) (sword errcode, (CONST OraText *) errmsg);
The two parameters of err_handler
are:
A numerical error value.
The error message text.
Number of parameters to be read from params.
If the value of num_params
exceeds the size of array params
, unexpected behavior results.
Comments
See Also:
"OCI Support for XML" for a usage example.Returns
Returns either:
A pointer to structure xmlctx
, with error handler and callbacks populated with appropriate values. This is later used for all OCI calls.
NULL, if no database connection is available.
Related Functions