共用方式為


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)>。

請參閱

概念

ODBC API 實作詳細資料

其他資源

SQLSetStmtAttr 函數