備妥語句的數據表值參數元數據
適用於: SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)
應用程式可以透過 SQLNumParams 和 SQLDescribeParam 取得備妥過程調用的元數據。 針對數據表值參數, DataTypePtr 會設定為 SQL_SS_TABLE。 其他元數據可透過 SQLGetDescField 取得,適用於SQL_CA_SS_TYPE_NAME、SQL_CA_SS_CATALOG_NAME和SQL_CA_SS_SCHEMA_NAME。
SQL_CA_SS_TYPE_NAME、SQL_CA_SS_CATALOG_NAME和SQL_CA_SS_SCHEMA_NAME可以與 SQLColumns 搭配使用,以取得數據表值參數相關聯之數據表類型的數據行元數據。 在此情況下,必須先將SQL_SOPT_SS_NAME_SCOPE設定為SQL_SS_NAME_SCOPE_TABLE_TYPE,才能呼叫 SQLColumns。 然後,當應用程式完成擷取數據表值參數數據行元數據時,SQL_SOPT_SS_NAME_SCOPE應該設定回預設值SQL_SS_NAME_SCOPE_TABLE。
SQL_CA_SS_TYPE_NAME、SQL_CA_SS_CATALOG_NAME和SQL_CA_SS_SCHEMA_NAME也可以搭配CLR用戶定義型別參數使用。
您無法取得非預存過程調用之已備妥語句的數據表值參數元數據。 如果您嘗試這樣做,應用程式會傳回具有 SQLSTATE 42000 的SQL_ERROR,並傳回「語法錯誤或存取違規」訊息。