SQLGetStmtAttr

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics 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 seulement que SQL Server n'a pas retourné de nombre de lignes. Si SQL_NC_OFF est retourné, cela signifie que l'option NOCOUNT est désactivée et la valeur 0 de SQLRowCount indique que l'instruction n'a affecté aucune ligne.

Les applications ne doivent pas afficher la valeur de SQLRowCount quand SQL_SOPT_SS_NOCOUNT_STATUS a la valeur 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ètres 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

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