SQLAllocHandle

Prototypes


SQLRETURN SQLAllocHandle(SQLSMALLINT HandleType, SQLHANDLE InputHandle, SQLHANDLE *OutputHandlePtr);

Description

Alloue un nouvel handle du type HandleType rattaché à l'environnement InputHandle. Le nouvel handle est rangé dans OutputHandlePtr.

Les valeurs possibles de HandleType sont les suivantes :

SQL_HANDLE_ENV.
Pour un handle sur un environnement. En ce cas, InputHandle doit valoir SQL_NULL_HANDLE.
SQL_HANDLE_DBC.
Pour un handle sur une connexion.
SQL_HANDLE_STLT.
Pour un handle sur un ordre Sql.

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

Exemple


#include <sqlcli1.h>



static SQLHANDLE hEnvironnement;

static SQLHANDLE hConnexion;



...

if (SQLAllocHandle(SQL_HANDLE_DBC, hEnvironnement, &hConnexion)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLFreeHandle(SQL_HANDLE_DBC, &hConnexion)!=SQL_SUCCESS)

   {

   ...

   }

...

Voir aussi

SQLFreeHandle pour libérer un handle alloué.