'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)".

Weitere Informationen

SQLSetStmtAttr-Funktion
ODBC-API-Implementierungsdetails