SQLGetConnectAttr

Prototypes


SQLRETURN SQLGetConnectAttr(SQLHDBC ConnectionHandle, SQLINTEGER Attribute, SQLPOINTER ValuePtr, SQLINTEGER BufferLength, SQLINTEGER *StringLengthPtr);

Description

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

La valeur de l'option est lue dans par le paramètre ValuePtr de taille BufferLength. Eventuellement, la taille de sortie est rangée dans le paramètre StringLengthPtr.

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

SQLSetConnectAttr pour écrire la valeur d'une option de la connexion.