SQLSetStmtAttr

Prototypes


SQLRETURN SQLSetStmtAttr(SQLHSTMT StatementHandle, SQLINTEGER Attribute, SQLPOINTER ValuePtr, SQLINTEGER StringLength);

Description

Fixe la valeur de l'option identifiée par Attribute pour l'ordre Sql identifié par StatementHandle.

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

Voici les attributs usuels :

SQL_ATTR_DEFERRED_PREPARE.
Fixe l'état d'analyse synchrone ou non de l'ordre Sql.
SQL_ATTR_NOSCAN.
Fixe l'état de recherche des extensions dans l'ordre Sql.
SQL_ATTR_QUERY_TIMEOUT.
Fixe le délai maximal d'exécution de l'ordre Sql en secondes.
SQL_ATTR_CURSOR_SCROLLABLE.
Fixe l'état de parcours du curseur de l'ordre Sql.
SQL_ATTR_CURSOR_TYPE.
Fixe le type du curseur de l'ordre Sql.
SQL_ATTR_BLOCK_FOR_NROWS.
Fixe la taille d'un paquet échangé entre le client et le serveur.
SQL_ATTR_PARAMSET_SIZE.
Fixe la taille des tableaux des paramètres.
SQL_ATTR_ROW_ARRAY_SIZE.
Fixe la taille des tableaux des résultats.
SQL_ATTR_ROWS_FETCHED_PTR.
Récupère la taille utilisée des tableaux des résultats.

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

Exemple


#include <sqlcli1.h>



static SQLHANDLE hConnexion;

static SQLINTEGER Option;



...

if (SQLSetStmtAttr(hConnexion, SQL_ATTR_DEFERRED_PREPARE, (SQLPOINTER)SQL_DEFERRED_PREPARE_ON, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetStmtAttr(hConnexion, SQL_ATTR_NOSCAN, (SQLPOINTER)SQL_NOSCAN_ON, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetStmtAttr(hConnexion, SQL_ATTR_QUERY_TIMEOUT, (SQLPOINTER)30, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetStmtAttr(hConnexion, SQL_ATTR_CURSOR_TYPE, (SQLPOINTER)SQL_NONSCROLLABLE, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetStmtAttr(hConnexion, SQL_ATTR_CURSOR_SCROLLABLE, (SQLPOINTER)SQL_NONSCROLLABLE, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetStmtAttr(hConnexion, SQL_ATTR_BLOCK_FOR_NROWS, (SQLPOINTER)8192, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetStmtAttr(hConnexion, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTER)256, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLSetStmtAttr(hConnexion, SQL_ATTR_ROW_ARRAY_SIZE, (SQLPOINTER)256, SQL_NTS)!=SQL_SUCCESS)

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_DEFERRED_PREPARE, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_NOSCAN, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_QUERY_TIMEOUT, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_CURSOR_TYPE, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_CURSOR_SCROLLABLE, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_BLOCK_FOR_NROWS, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_PARAMSET_SIZE, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_ROW_ARRAY_SIZE, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

if (SQLGetStmtAttr(hConnexion, SQL_ATTR_ROWS_FETCHED_PTR, (SQLPOINTEUR)&Option, sizeof(SQLINTEGER), NULL)!=SQL_SUCCESS) 

   {

   ...

   }

...

Voir aussi

SQLGetStmtAttr pour lire la valeur d'une option de l'ordre Sql.