OCIHandleAlloc

Prototypes


sword OCIHandleAlloc(dvoid *parenth, dvoid **hndlpp, ub4 type, size_t xtramem_sz, dvoid **usrmempp);

Description

Alloue le handle hndlpp de type type en le rattachant à l'environnement parenth. Les valeurs possibles pour type sont :

OCI_HTYPE_SVCCTX.
Pour une connexion.
OCI_HTYPE_STMT.
Pour un ordre Sql.
OCI_HTYPE_ERROR.
Pour un descripteur d'erreur.
OCI_DTYPE_LOB.
Pour un objet long.

Le résultat est OCI_SUCCESS en cas de succès.

Exemple


#include <ociap.h>



static OCIEnv *hEnvironnement;

static OCIStmt *hOrdreSql;

static OCIError *hErreur;

static OCILobLocator *hBinaire;

...

if (OCIHandleAlloc(hEnvironnement, (dvoid **)&hErreur, (ub4)OCI_HTYPE_ERROR, 0, NULL)!=OCI_SUCCESS)

   {

   ...

   }


...

if (OCIHandleAlloc(hEnvironnement, (dvoid **)&hOrdreSql, (ub4)OCI_HTYPE_STMT, 0, NULL)!=OCI_SUCCESS)

   {

   ...

   }


...

if (OCIHandleAlloc(hEnvironnement, (dvoid **)&hOrdreSql, (ub4)OCI_DTYPE_LOB, 0, NULL)!=OCI_SUCCESS)

   {

   ...

   }


...

OCIHandleFree((dvoid *)hOrdreSql, OCI_DTYPE_LOB);

...

OCIHandleFree((dvoid *)hOrdreSql, OCI_HTYPE_STMT);

...

OCIHandleFree((dvoid *)hErreur, OCI_HTYPE_ERROR);

...

Voir aussi

OCIHandleFree pour libérer un handle.