SQLGetStmtAttr

SQL Server Native Client ODBC 驅動程式會擴充 SQLGetStmtAttr 來公開驅動程式特定的語句屬性。

SQLSetStmtAttr 會列出同時讀取和寫入的語句屬性。 本主題將列出唯讀的陳述式屬性。

SQL_SOPT_SS_CURRENT_COMMAND

SQL_SOPT_SS_CURRENT_COMMAND 屬性會公開命令批次的目前命令。 傳回值是一個整數,可指定此命令在批次中的位置。 ValuePtr值的類型為 SQLLEN。

SQL_SOPT_SS_NOCOUNT_STATUS

SQL_SOPT_SS_NOCOUNT_STATUS 屬性指出 NOCOUNT 選項的目前設定,可控制呼叫SQLRowCount時,是否SQL Server報告語句所影響的資料列數目。 ValuePtr值的類型為 SQLLEN。

描述
SQL_NC_OFF NOCOUNT 為 OFF。 SQLRowCount 會傳回受影響的資料列數目。
SQL_NC_ON NOCOUNT 為 ON。 SQLRowCount 不會傳回受影響的資料列數目,而傳回的值是 0。

如果 SQLRowCount 傳回 0,應用程式應該測試SQL_SOPT_SS_NOCOUNT_STATUS。 如果傳回 SQL_NC_ON,SQLRowCount 的值為 0 時,只表示 SQL Server 尚未傳回資料列計數。 如果傳回 SQL_NC_OFF,表示 NOCOUNT 是關閉的,而 SQLRowCount 的值為 0 時,表示陳述式沒有影響任何資料列。

當 SQL_SOPT_SS_NOCOUNT_STATUS 為 SQL_NC_OFF 時,應用程式不應該顯示 SQLRowCount 的值。 大型批次或預存程序可包含多個 SET NOCOUNT 陳述式,因此無法假設 SQL_SOPT_SS_NOCOUNT_STATUS 仍為常數。 每次 SQLRowCount 傳回 0 時,都應該測試此選項。

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT 屬性會傳回查詢通知要求的訊息文字。

SQLGetStmtAttr 和資料表值參數

當使用資料表值參數時,可以呼叫 SQLGetStmtAttr 來取得應用程式參數描述元 (APD) 中的SQL_SOPT_SS_PARAM_FOCUS值。 如需SQL_SOPT_SS_PARAM_FOCUS的詳細資訊,請參閱 SQLSetStmtAttr

如需資料表值參數的詳細資訊,請參閱 資料表值參數 (ODBC)

另請參閱

SQLSetStmtAttr 函數
ODBC API 實作詳細資料