Freigeben über


SQLGetStmtAttr

Der ODBC-Treiber für SQL Server Native Client erweitert SQLGetStmtAttr, um treiberspezifische Anweisungsattribute verfügbar zu machen.

SQLSetStmtAttr listet Anweisungsattribute auf, die sowohl lese- als auch schreibgeschützt sind. In diesem Thema werden die schreibgeschützten Anweisungsattribute aufgeführt.

SQL_SOPT_SS_CURRENT_COMMAND

Das attribut SQL_SOPT_SS_CURRENT_COMMAND macht den aktuellen Befehl eines Befehlsbatches verfügbar. Die Rückgabe ist eine ganze Zahl, die 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 AUS. 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 attribut SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT gibt den Nachrichtentext 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)".

Siehe auch

SQLSetStmtAttr-Funktion
ODBC-API-Implementierungsdetails