SQLDescribeParam
在已備妥的 ODBC 陳述式控制代碼上呼叫 SQLDescribeParam 時，SQL Server Native Client ODBC 驅動程式會建置並執行 Transact-SQL SELECT 陳述式，以描述任何 SQL 陳述式的參數。此驅動程式在執行查詢時會使用 SET FMTONLY 陳述式。結果集的中繼資料則會決定已備妥之陳述式中的參數特性。
請考慮這個 ODBC SQL 陳述式：
INSERT INTO Shippers (ShipperID, CompanyName, Phone) VALUES (?, ?, ?)
在 SQLDescribeParam 的呼叫上，這個 ODBC SQL 陳述式會導致驅動程式執行下列的 Transact-SQL 陳述式：
SET FMTONLY ON
SELECT ShipperID, CompanyName, Phone FROM Shippers
SET FMTONLY OFF
因此，SQLDescribeParam 可能會傳回 SQLExecute 或 SQLExecDirect 所可能傳回的任何錯誤碼。
此外，驅動程式在下列情況下不支援呼叫 SQLDescribeParam：
針對包含 FROM 子句的任何 Transact-SQL UPDATE 或 DELETE 陳述式的 SQLExecDirect 之後。
針對在 HAVING 子句中包含參數或與 SUM 函數的結果相比較的任何 ODBC 或 Transact-SQL 陳述式。
針對相依於包含參數之子查詢的任何 ODBC 或 Transact-SQL 陳述式。
針對在比較 (like) 或定量述詞的運算式中都包含參數標記的 ODBC SQL 陳述式。
針對其中一個參數為函數參數的任何查詢。
當 Transact-SQL 命令中有註解 (/* */) 時。
在處理 Transact-SQL 陳述式批次時，驅動程式也不支援針對批次內第一個陳述式之後的陳述式中的參數標記呼叫 SQLDescribeParam。
在描述已備妥預存程序的參數時，SQLDescribeParam 會使用系統預存程序 sp_sproc_columns 來擷取參數特性。sp_sproc_columns 可以針對預存程序來報告目前使用者資料庫內的資料。請準備完整的預存程序名稱，以在不同的資料庫間執行 SQLDescribeParam。例如，系統預存程序 sp_who 可在任何資料庫中以下列方式準備和執行：
SQLPrepare(hstmt, "{call sp_who(?)}", SQL_NTS);
當連接到 master 以外的任何資料庫時，在成功的準備之後執行 SQLDescribeParam 會傳回空白的資料列集。不論目前的使用者資料庫為何，依下列方式所準備的相同呼叫都會導致 SQLDescribeParam 成功：
SQLPrepare(hstmt, "{call master..sp_who(?)}", SQL_NTS);
如果是大數値資料類型，以 DataTypePtr 傳回的値為 SQL_VARCHAR、SQL_VARBINARY 或 SQL_NVARCHAR。若要指出大數値資料類型參數的大小為「無限制」，SQL Server Native Client ODBC 驅動程式會將 ParameterSizePtr 設定為 0。實際大小値則會以標準 varchar 參數傳回。
[!附註]
如果參數已與 SQL_VARCHAR、SQL_VARBINARY 或 SQL_WVARCHAR 參數的最大大小繫結，則會傳回參數的繫結大小，而不是「無限制」。
若要繫結「無限制」大小輸入參數，則必須使用資料執行中 (data-at-execution)。您無法繫結「無限制」大小的輸出參數 (無法像 SQLGetData 對結果集所進行的作業一般，從輸出參數對資料進行資料流處理)。
對輸出參數而言，必須繫結緩衝區，而且如果値過大，則緩衝區會填滿，並且傳回 SQL_SUCCESS_WITH_INFO 訊息及「字串資料；右側截斷」警告。之後會捨棄截斷的資料。
SQLDescribeParam 和資料表値參數
應用程式可以使用 SQLDescribeParam 擷取已備妥之陳述式的資料表値參數資訊。如需詳細資訊，請參閱＜已備妥之陳述式的資料表值參數中繼資料＞。
如需有關一般資料表値參數的詳細資訊，請參閱＜資料表值參數 (ODBC)＞。
SQLDescribeParam 對增強日期和時間功能的支援
針對日期/時間類型所傳回的値如下：
DataTypePtr |
ParameterSizePtr |
DecimalDigitsPtr |
|
|---|---|---|---|
datetime |
SQL_TYPE_TIMESTAMP |
23 |
3 |
smalldatetime |
SQL_TYPE_TIMESTAMP |
16 |
0 |
date |
SQL_TYPE_DATE |
10 |
0 |
time |
SQL_SS_TIME2 |
8, 10..16 |
0..7 |
datetime2 |
SQL_TYPE_TIMESTAMP |
19, 21..27 |
0..7 |
datetimeoffset |
SQL_SS_TIMESTAMPOFFSET |
26, 28..34 |
0..7 |
如需詳細資訊，請參閱＜ODBC 日期/時間的改善 (ODBC)＞。
大型 CLR UDT 的 SQLDescribeParam 支援
SQLDescribeParam 支援大型 CLR 使用者定義型別 (UDT)。如需詳細資訊，請參閱＜大型 CLR 使用者定義型別 (ODBC)＞。