'SQLGetStmtAttr'
Gilt für:
SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)
Der ODBC-Treiber für SQL Server Native Client erweitert SQLGetStmtAttr, um treiberspezifische Anweisungsattribute verfügbar zu machen.
SQLSetStmtAttr listet Anweisungsattribute auf, auf die sowohl Schreib- als auch Lesezugriff möglich ist. In diesem Thema sind die schreibgeschützten Anweisungsattribute aufgeführt.
SQL_SOPT_SS_CURRENT_COMMAND
Das SQL_SOPT_SS_CURRENT_COMMAND-Attribut macht den aktuellen Befehl eines Befehlsbatches verfügbar. Zurückgegeben wird ein ganzzahliger Wert, der die Position des Befehls im Batch angibt. Der ValuePtr -Wert ist vom Typ SQLLEN.
SQL_SOPT_SS_NOCOUNT_STATUS
Das attribut SQL_SOPT_SS_NOCOUNT_STATUS gibt die aktuelle Einstellung der NOCOUNT-Option an, die steuert, ob SQL Server die Anzahl von Zeilen meldet, die von einer Anweisung betroffen sind, wenn SQLRowCount aufgerufen wird. Der ValuePtr -Wert ist vom Typ SQLLEN.
| Wert | Beschreibung |
|---|---|
| SQL_NC_OFF | NOCOUNT ist OFF. SQLRowCount gibt die Anzahl der betroffenen Zeilen zurück. |
| SQL_NC_ON | NOCOUNT ist ON. Die Anzahl der betroffenen Zeilen wird von SQLRowCount nicht zurückgegeben, und der zurückgegebene Wert ist 0. |
Wenn SQLRowCount 0 zurückgibt, sollte die Anwendung SQL_SOPT_SS_NOCOUNT_STATUS testen. Wenn SQL_NC_ON zurückgegeben wird, gibt der Wert 0 von SQLRowCount nur an, dass SQL Server keine Zeilenanzahl zurückgegeben hat. Wenn SQL_NC_OFF zurückgegeben wird, bedeutet dies, dass NOCOUNT deaktiviert ist und der Wert 0 von SQLRowCount angibt, dass die Anweisung keine Zeilen beeinflusst hat.
Anwendungen sollten den Wert von SQLRowCount nicht anzeigen, wenn SQL_SOPT_SS_NOCOUNT_STATUS SQL_NC_OFF ist. Große Batches oder gespeicherte Prozeduren können mehrere SET NOCOUNT-Anweisungen enthalten. Daher kann nicht davon ausgegangen werden, dass SQL_SOPT_SS_NOCOUNT_STATUS konstant bleibt. Diese Option sollte jedes Mal getestet werden, wenn SQLRowCount 0 zurückgibt.
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
Das SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT-Attribut gibt den Meldungstext für die Abfragebenachrichtigungsanforderung zurück.
'SQLGetStmtAttr' und Tabellenwertparameter
SQLGetStmtAttr kann aufgerufen werden, um den Wert von SQL_SOPT_SS_PARAM_FOCUS im Anwendungsparameterdeskriptor (APD) beim Arbeiten mit Tabellenwertparametern abzurufen. Weitere Informationen zu SQL_SOPT_SS_PARAM_FOCUS finden Sie unter SQLSetStmtAttr.
Weitere Informationen zu Tabellenwertparametern finden Sie unter "Table-Valued Parameters (ODBC)".