Partage via


SQLGetStmtAttr

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Le pilote ODBC SQL Server Native Client étend SQLGetStmtAttr pour exposer des attributs d’instruction spécifiques au pilote.

SQLSetStmtAttr répertorie les attributs d'instruction qui sont à la fois accessibles en lecture et en écriture. Cette rubrique dresse la liste des attributs d'instruction accessibles en lecture seule.

SQL_SOPT_SS_CURRENT_COMMAND

L'attribut SQL_SOPT_SS_CURRENT_COMMAND expose la commande active d'un lot de commandes. La valeur retournée est un entier qui spécifie l'emplacement de la commande dans le lot. La valeur de ValuePtr est de type SQLLEN.

SQL_SOPT_SS_NOCOUNT_STATUS

L’attribut SQL_SOPT_SS_NOCOUNT_STATUS indique le paramètre actuel de l’option NOCOUNT, qui contrôle si SQL Server signale le nombre de lignes affectées par une instruction lorsque SQLRowCount est appelé. La valeur de ValuePtr est de type SQLLEN.

Valeur Description
SQL_NC_OFF NOCOUNT a la valeur OFF. SQLRowCount retourne le nombre de lignes affectées.
SQL_NC_ON NOCOUNT a la valeur ON. Le nombre de lignes affectées n’est pas retourné par SQLRowCount et la valeur retournée est 0.

Si SQLRowCount retourne 0, l’application doit tester SQL_SOPT_SS_NOCOUNT_STATUS. Si SQL_NC_ON est retourné, la valeur 0 de SQLRowCount indique uniquement que SQL Server n’a pas retourné de nombre de lignes. Si SQL_NC_OFF est retourné, cela signifie que NOCOUNT est désactivé et que la valeur 0 de SQLRowCount indique que l’instruction n’a pas affecté de lignes.

Les applications ne doivent pas afficher la valeur de SQLRowCount lorsque SQL_SOPT_SS_NOCOUNT_STATUS est SQL_NC_OFF. Les lots ou procédures stockées de grande taille peuvent contenir plusieurs instructions SET NOCOUNT. Il n'est donc pas possible de supposer que SQL_SOPT_SS_NOCOUNT_STATUS reste constant. Cette option doit être testée chaque fois que SQLRowCount retourne 0.

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

L'attribut SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT retourne le texte du message pour la demande de notification de requête.

SQLGetStmtAttr et paramètres table

SQLGetStmtAttr peut être appelé pour obtenir la valeur de SQL_SOPT_SS_PARAM_FOCUS dans le descripteur de paramètre d’application (APD) lors de l’utilisation de paramètres table. Pour plus d'informations sur SQL_SOPT_SS_PARAM_FOCUS, consultez SQLSetStmtAttr.

Pour plus d’informations sur les paramètres table, consultez Paramètres table (ODBC) .

Voir aussi

SQLSetStmtAttr, fonction
Détails de l’implémentation d’API ODBC