Files correlati : Commento : - Creazione nuova cartella per contenere tutte le librerie esterne - Aggiunta nuova libreria sqlapi per interfacciare campo a vari DB git-svn-id: svn://10.65.10.50/branches/R_10_00@24149 c028cbd2-c16b-5b4b-a496-9718f37d4682
		
			
				
	
	
		
			318 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			318 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*
 | 
						|
 * 
 | 
						|
 */
 | 
						|
 | 
						|
/* Copyright (c) 1998, 2005, Oracle. All rights reserved.  */
 | 
						|
 
 | 
						|
/* 
 | 
						|
   NAME 
 | 
						|
     oci8dp.h - OCI: Direct Path API interface prototypes.
 | 
						|
 | 
						|
   DESCRIPTION 
 | 
						|
     Public types, constants, and interfaces to the direct path API.
 | 
						|
 | 
						|
   RELATED DOCUMENTS 
 | 
						|
 
 | 
						|
   NOTES
 | 
						|
     This file is not directly included by the application, this file
 | 
						|
     is included by "oci.h", which the application should include.
 | 
						|
 | 
						|
   MODIFIED   (MM/DD/YY)
 | 
						|
   dmukhin     06/29/05 - ANSI prototypes; miscellaneous cleanup 
 | 
						|
   rphillip    02/27/04 - Add OCI_DIRPATH_COL_ERROR 
 | 
						|
   srseshad    03/12/03 - convert oci public api to ansi
 | 
						|
   msakayed    10/28/02 - Bug #2643907: add OCI_ATTR_DIRPATH_SKIPINDEX_METHOD
 | 
						|
   cmlim       04/13/01 - remove OCIDirPathStreamToStream - not used by dpapi
 | 
						|
   cmlim       04/02/01 - OCI_DIRPATH_EXPR_OPQ_SQL_FN to OCI_DIRPATH_EXPR_SQL
 | 
						|
   ebatbout    01/22/01 - PARTIAL value for OCIDirPathDataSave action parameter
 | 
						|
   cmlim       07/20/00 - support opaques/sql strings in 8.2 dpapi
 | 
						|
   cmlim       08/14/00 - support refs in 8.2 dpapi
 | 
						|
   cmlim       04/17/00 - add defines for OCIDirPathFuncCtx handle & OCI_ATTR_D
 | 
						|
   whe         09/01/99 - 976457:check __cplusplus for C++ code
 | 
						|
   abrumm      04/16/99 - dpapi: more attributes
 | 
						|
   abrumm      02/26/99 - add defines for DataSave action
 | 
						|
   abrumm      10/04/98 - clen must be a ub4
 | 
						|
   abrumm      05/27/98 - add column array flag values
 | 
						|
   abrumm      05/12/98 - direct path api support
 | 
						|
   abrumm      03/31/98 - OCI direct path interface support
 | 
						|
   abrumm      03/18/98 - Creation
 | 
						|
 | 
						|
*/
 | 
						|
 | 
						|
#ifndef OCI8DP_ORACLE
 | 
						|
# define OCI8DP_ORACLE
 | 
						|
 | 
						|
#ifndef ORATYPES
 | 
						|
#include <oratypes.h>
 | 
						|
#endif
 | 
						|
 | 
						|
#ifndef OCIDFN
 | 
						|
#include <ocidfn.h>
 | 
						|
#endif
 | 
						|
 | 
						|
#ifndef OCI_ORACLE
 | 
						|
#include <oci.h>
 | 
						|
#endif
 | 
						|
 | 
						|
 | 
						|
/*---------------------------------------------------------------------------
 | 
						|
                     PUBLIC TYPES AND CONSTANTS
 | 
						|
  ---------------------------------------------------------------------------*/
 | 
						|
 | 
						|
/*----- Handles and descriptors for direct path operations (OCIDirPath*) ----*/
 | 
						|
 | 
						|
typedef struct OCIDirPathCtx      OCIDirPathCtx;                  /* context */
 | 
						|
typedef struct OCIDirPathFuncCtx  OCIDirPathFuncCtx;     /* function context */
 | 
						|
typedef struct OCIDirPathColArray OCIDirPathColArray;        /* column array */
 | 
						|
typedef struct OCIDirPathStream   OCIDirPathStream;                /* stream */
 | 
						|
typedef struct OCIDirPathDesc     OCIDirPathDesc;  /* direct path descriptor */
 | 
						|
 | 
						|
                 /*----- Defines for Direct Path Options -----*/
 | 
						|
 | 
						|
                 /* values for OCI_ATTR_DIRPATH_MODE attribute */
 | 
						|
#define OCI_DIRPATH_LOAD         1             /* direct path load operation */
 | 
						|
#define OCI_DIRPATH_UNLOAD       2           /* direct path unload operation */
 | 
						|
#define OCI_DIRPATH_CONVERT      3     /* direct path convert only operation */
 | 
						|
 | 
						|
    /*----- values for OCI_ATTR_DIRPATH_INDEX_MAINT_METHOD attribute -----*/
 | 
						|
#define OCI_DIRPATH_INDEX_MAINT_SINGLE_ROW     1
 | 
						|
 | 
						|
/* Note that there are two attributes dealing with index maintenance -
 | 
						|
 * OCI_ATTR_DIRPATH_INDEX_MAINT_METHOD and OCI_ATTR_DIRPATH_SKIPINDEX_METHOD.
 | 
						|
 * OCI_ATTR_DIRPATH_SKIPINDEX_METHOD exists to isolate the behavior for
 | 
						|
 * skipping index maintenance since maintenance of unusable indexes is 
 | 
						|
 * orthogonal to that of single row insertion.
 | 
						|
 * For backwards compatibility we still allow users to specify skip
 | 
						|
 * methods in OCI_ATTR_DIRPATH_INDEX_MAINT_METHOD so make sure the
 | 
						|
 * enumerations for the two attributes are distinct.
 | 
						|
 */
 | 
						|
    /*----- values for OCI_ATTR_DIRPATH_SKIPINDEX_METHOD attribute -----*/
 | 
						|
#define OCI_DIRPATH_INDEX_MAINT_SKIP_UNUSABLE       2
 | 
						|
#define OCI_DIRPATH_INDEX_MAINT_DONT_SKIP_UNUSABLE  3
 | 
						|
#define OCI_DIRPATH_INDEX_MAINT_SKIP_ALL            4
 | 
						|
 | 
						|
           /* values for OCI_ATTR_STATE attribute of OCIDirPathCtx */
 | 
						|
#define OCI_DIRPATH_NORMAL       1     /* can accept rows, last row complete */
 | 
						|
#define OCI_DIRPATH_PARTIAL      2                   /* last row was partial */
 | 
						|
#define OCI_DIRPATH_NOT_PREPARED 3    /* direct path context is not prepared */
 | 
						|
 | 
						|
     /*----- values for cflg argument to OCIDirpathColArrayEntrySet -----*/
 | 
						|
#define OCI_DIRPATH_COL_COMPLETE 0                /* column data is complete */
 | 
						|
#define OCI_DIRPATH_COL_NULL     1                         /* column is null */
 | 
						|
#define OCI_DIRPATH_COL_PARTIAL  2                 /* column data is partial */
 | 
						|
#define OCI_DIRPATH_COL_ERROR    3               /* column error, ignore row */
 | 
						|
          /*----- values for action parameter to OCIDirPathDataSave -----*/
 | 
						|
#define OCI_DIRPATH_DATASAVE_SAVEONLY 0              /* data save point only */
 | 
						|
#define OCI_DIRPATH_DATASAVE_FINISH   1           /* execute finishing logic */
 | 
						|
/* save portion of input data (before space error occurred) and finish */
 | 
						|
#define OCI_DIRPATH_DATASAVE_PARTIAL  2       
 | 
						|
 | 
						|
  /*- OCI_ATTR_DIRPATH_EXPR_TYPE values (describes OCI_ATTR_NAME expr type) -*/
 | 
						|
#define OCI_DIRPATH_EXPR_OBJ_CONSTR  1      /* NAME is an object constructor */
 | 
						|
#define OCI_DIRPATH_EXPR_SQL         2  /* NAME is an opaque or sql function */
 | 
						|
#define OCI_DIRPATH_EXPR_REF_TBLNAME 3 /* NAME is table name if ref is scoped*/
 | 
						|
 | 
						|
 | 
						|
/*---------------------------------------------------------------------------
 | 
						|
                           PUBLIC FUNCTIONS
 | 
						|
  ---------------------------------------------------------------------------*/
 | 
						|
 | 
						|
/*------------------------ OCIDirPathCtx Operations -------------------------*/
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathAbort - OCI: Abort a direct path operation.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Aborts a direct path operation.  Upon successful completion
 | 
						|
    the direct path context is no longer valid.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathAbort( OCIDirPathCtx *dpctx, OCIError *errhp );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathDataSave - OCI: Execute a data save point.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Successful return of this function indicates that a data save
 | 
						|
    point has been executed.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathDataSave( OCIDirPathCtx *dpctx, OCIError *errhp, ub4 action );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathFinish - OCI: Finish a direct path operation.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Finishes a direct path operation.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathFinish( OCIDirPathCtx *dpctx, OCIError  *errhp );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathFlushRow - OCI: Flush a partial row from the server.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Flushes a partially loaded row from the server.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathFlushRow( OCIDirPathCtx *dpctx, OCIError  *errhp );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathPrepare - OCI: Prepare a direct path operation.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Prepares a table/partition for a direct path operation.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathPrepare( OCIDirPathCtx *dpctx, OCISvcCtx *svchp,
 | 
						|
                      OCIError  *errhp );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathLoadStream - OCI: Load a direct path stream.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Load a direct path stream to the object associated with
 | 
						|
    the direct path context.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathLoadStream( OCIDirPathCtx *dpctx, OCIDirPathStream *dpstr,
 | 
						|
                         OCIError      *errhp );
 | 
						|
 | 
						|
 | 
						|
/*---------------------- OCIDirPathColArray Operations ----------------------*/
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathColArrayEntryGet - OCI:  Get column array entry.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Column array function which is used to get a specified entry in
 | 
						|
    a column array.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathColArrayEntryGet( OCIDirPathColArray *dpca, OCIError *errhp,
 | 
						|
                              ub4 rownum, ub2 colIdx, ub1 **cvalpp, ub4 *clenp,
 | 
						|
                              ub1 *cflgp );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathColArrayEntrySet - OCI:  Set column array entry.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Column array function which is used to set a specified entry in
 | 
						|
    a column array.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathColArrayEntrySet( OCIDirPathColArray *dpca, OCIError *errhp,
 | 
						|
                               ub4 rownum, ub2 colIdx, ub1 *cvalp, ub4 clen,
 | 
						|
                               ub1 cflg );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathColArrayRowGet - OCI:  Get column array row pointers.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Column array function which is used to get the base row pointers
 | 
						|
    for a specified row in a column array.
 | 
						|
    To be used in lieu of OCIDirPathColArrayEntryGet() and
 | 
						|
    OCIDirPathColArrayEntrySet().
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathColArrayRowGet( OCIDirPathColArray *dpca, OCIError *errhp,
 | 
						|
                         ub4 rownum, ub1 ***cvalppp, ub4 **clenpp,
 | 
						|
                         ub1 **cflgpp );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathColArrayReset - OCI: Reset Column Array State
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Function which resets the column array state.
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
    Resetting the column array state is necessary when piecing in a large
 | 
						|
    column and an error occurs in the middle of loading the column.
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathColArrayReset( OCIDirPathColArray *dpca, OCIError *errhp );
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathColArrayToStream - OCI: Convert Column Array to Stream Format.
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
    Convert from column array format to stream format which is suitable
 | 
						|
    for loading via OCIDirPathLoadStream().
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathColArrayToStream( OCIDirPathColArray *dpca,  OCIDirPathCtx *dpctx,
 | 
						|
                               OCIDirPathStream   *dpstr, OCIError      *errhp,
 | 
						|
                               ub4 rowcnt, ub4 rowoff );
 | 
						|
 | 
						|
 | 
						|
 | 
						|
/*----------------------- OCIDirPathStream Operations -----------------------*/
 | 
						|
 | 
						|
/*
 | 
						|
  NAME
 | 
						|
    OCIDirPathStreamReset - OCI:
 | 
						|
 | 
						|
  DESCRIPTION
 | 
						|
 | 
						|
  RETURNS
 | 
						|
    An OCI error code, Oracle errors are returned via the error handle.
 | 
						|
  NOTES
 | 
						|
 */
 | 
						|
sword
 | 
						|
OCIDirPathStreamReset( OCIDirPathStream *dpstr, OCIError *errhp );
 | 
						|
 | 
						|
#endif                                              /* OCI8DP_ORACLE */
 |