描述項控制代碼

從應用程式或驅動程式的角度來看，描述項是中繼資料的集合，說明 SQL 陳述式參數或結果集的資料行 (也稱為實作)。 因此，描述項可滿足以下四種角色：

• 應用程式參數描述項 (APD)。 包含繫結至 SQL 陳述式參數的應用程式緩衝區相關資訊，例如其位址、長度和 C 資料類型。

• 實作參數描述項 (IPD)。 包含 SQL 陳述式參數的相關資訊，例如其 SQL 資料類型、長度和可 NULL 性。

• 應用程式資料列描述項 (ARD)。 包含繫結至結果集資料行的應用程式緩衝區相關資訊，例如其位址、長度和 C 資料類型。

• 實作資料列描述項 (IRD)。 包含結果集中資料行的相關資訊，例如其 SQL 資料類型、長度和可 NULL 性。

配置陳述式時，四個描述項 (一個描述項滿足每個角色) 會自動進行配置。 這些描述項稱為已自動配置的描述項，且一律與該陳述式相關聯。 應用程式也可以使用 SQLAllocHandle 來配置描述項。 這些描述項稱為明確配置的描述項。 其會配置在連線上，而且可以與該連線上的一或多個陳述式相關聯，以滿足這些陳述式上 APD 或 ARD 的角色。

ODBC 中的大部分作業都可以執行，而不需要應用程式明確使用描述項。 不過，描述項可為某些作業提供便利的捷徑。 例如，假設應用程式想要從兩組不同的緩衝區插入資料。 若要使用第一組緩衝區，應用程式會重複呼叫 SQLBindParameter，將其繫結至 INSERT 陳述式中的參數，然後執行陳述式。 若要使用第二組緩衝區，應用程式會重複此流程。 或者，其可在一個描述項中設定第一組緩衝區的繫結，並在另一個描述項中設定第二組緩衝區的繫結。 若要在繫結集合之間切換，應用程式只會呼叫 SQLSetStmtAttr，並將正確的描述項與陳述式建立關聯而成為 APD。

如需描述項的詳細資訊，請參閱描述項類型。