'SQLGetStmtAttr'

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Der SQL Server Native Client ODBC-Treibers 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 Option NOCOUNT an, die steuert, ob SQL Server die Anzahl der 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, zeigt der Wert 0 aus SQLRowCount lediglich an, dass SQL Server keine Zeilenanzahl zurückgegeben hat. Wird SQL_NC_OFF zurückgegeben, bedeutet dies, dass NOCOUNT deaktiviert ist, und der Wert 0 aus SQLRowCount zeigt an, dass keine Zeilen von der Anweisung betroffen waren.

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) abzurufen, wenn Sie mit Tabellenwertparametern arbeiten. Weitere Informationen zu SQL_SOPT_SS_PARAM_FOCUS finden Sie unter SQLSetStmtAttr.

Weitere Informationen zu Tabellenwertparametern finden Sie unter Tabellenwertparameter (ODBC).

Weitere Informationen

SQLSetStmtAttr-Funktion
ODBC API Implementation Details