SQLGetStmtAttr

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics 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 實作詳細資料