SQLDescribeCol
對於執行的陳述式而言,SQL Server Native Client ODBC 驅動程式不需要查詢伺服器來描述結果集中的資料行。在此情況下,SQLDescribeCol 不會造成伺服器往返。就像 SQLColAttribute和SQLNumResultCols,在已經備妥但是未執行的陳述式上呼叫 SQLDescribeCol 會產生伺服器往返。
當 Transact-SQL 陳述式或陳述式批次傳回多個結果資料列集時,按序數參考的資料行有可能源自於個別的資料表,或是參考結果集中完全不同的資料行。應該針對每一個資料列集呼叫 SQLDescribeCol。當結果集變更時,應用程式應該在提取資料列結果以前先重新繫結資料值。如需有關處理多個結果集傳回的詳細資訊,請參閱<SQLMoreResults>。
針對已備妥但未執行的陳述式呼叫 SQLDescribeCol 時,SQL Server Native Client ODBC 驅動程式會使用 SET FMTONLY 陳述式來減少伺服器的負擔。當已備妥的 SQL 陳述式批次產生多個結果集時,只有第一個結果集會報告資料行屬性。
如果是大數値資料類型,以 DataTypePtr 傳回的値為 SQL_VARCHAR、SQL_VARBINARY 或 SQL_NVARCHAR。ColumnSizePtr 中的 SQL_SS_LENGTH_UNLIMITED 值表示大小「不受限制」。
SQLDescribeCol 對增強型日期和時間功能的支援
針對日期/時間類型所傳回的値如下:
DataTypePtr |
ColumnSizePtr |
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)>。
SQLDescribeCol 對於大型 CLR UDT 的支援
SQLDescribeCol 支援大型 CLR 使用者定義型別 (UDT)。如需詳細資訊,請參閱<大型 CLR 使用者定義型別 (ODBC)>。