SQLSetConnectAttr

Prototypes


SQLRETURN SQLSetConnectAttr(SQLHDBC ConnectionHandle, SQLINTEGER Attribute, SQLPOINTER ValuePtr, SQLINTEGER StringLength);

Description

Fixe la valeur de l'option identifiée par Attribute pour la connexion identifiée par ConnectionHandle.

La valeur de l'option est donnée par le paramètre ValuePtr de taille StringLength.

Voici les attributs usuels :

SQL_ATTR_AUTOCOMMIT.
Fixe le mode de validation automatique des enregistrements.
SQL_ATTR_CONNECTION_TIMEOUT.
Fixe le délai maximal de connexion en secondes.
SQL_ATTR_PACKET_SIZE.
Fixe la taille des paquets échangés entre le client et le serveur.

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

Exemple


#include <windows.h>

#include <sql.h>

#include <sqlext.h>

#include <sqltypes.h>



static SQLHANDLE hConnexion;

static SQLINTEGER Option;



...

if (SQLSetConnectAttr(hConnexion, SQL_ATTR_PACKET_SIZE, (SQLPOINTER)8192, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetConnectAttr(hConnexion, SQL_ATTR_CONNECTION_TIMEOUT, (SQLPOINTER)30, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetConnectAttr(hConnexion, SQL_ATTR_AUTOCOMMIT, (SQLPOINTER)SQL_AUTOCOMMIT_OFF, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLGetConnectAttr(hConnexion, SQL_ATTR_PACKET_SIZE, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetConnectAttr(hConnexion, SQL_ATTR_CONNECTION_TIMEOUT, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetConnectAttr(hConnexion, SQL_ATTR_AUTOCOMMIT, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

Voir aussi

SQLGetConnectAttr pour lire la valeur d'une option de la connexion.