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