分享方式:


SQLGetStmtAttr

適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

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 選項的目前設定,控制 SQL Server 是否會在呼叫 SQLRowCount報告語句所影響的數據列數目。 ValuePtr 值的類型為 SQLLEN。

Description
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 實作詳細數據