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