共用方式為

描述項控制代碼

  • 發行項

描述項是元數據集合，描述 SQL 語句的參數或結果集的數據行，如應用程式或驅動程式所見（也稱為實作）。 因此，描述項可滿足以下四種角色：

  • 應用程式參數描述項 (APD)。 包含系結至 SQL 語句中參數的應用程式緩衝區相關信息，例如其位址、長度和 C 數據類型。

  • 實作參數描述項 (IPD)。 包含 SQL 語句中參數的相關信息，例如其 SQL 數據類型、長度和可為 Null 性。

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

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

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

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

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