Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 en lecture et en écriture. Cette rubrique répertorie les attributs d’instruction en lecture seule.
SQL_SOPT_SS_CURRENT_COMMAND
L’attribut SQL_SOPT_SS_CURRENT_COMMAND expose la commande actuelle d’un lot de commandes. Le retour est un entier qui spécifie l’emplacement de la commande dans le lot. La valeur 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 ValuePtr est de type SQLLEN.
| Valeur | Descriptif |
|---|---|
| SQL_NC_OFF | NOCOUNT est OFF. SQLRowCount retourne le nombre de lignes affectées. |
| SQL_NC_ON | NOCOUNT est 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 volumineux ou les procédures stockées peuvent contenir plusieurs instructions SET NOCOUNT. Il ne peut donc pas être supposé que SQL_SOPT_SS_NOCOUNT_STATUS reste constante. 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 de la demande de notification de requête.
Paramètres SQLGetStmtAttr et 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