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