SQLSetDescField

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)

SQLSetDescField 可用于设置表值参数和表值参数列的描述符字段。 有关可用字段的信息，请参阅 表值参数描述符字段 和 表值参数构成列的描述符字段。

注解

表值参数列仅在将描述符标头字段 SQL_SOPT_SS_PARAM_FOCUS 设置为特定记录（其 SQL_DESC_TYPE 设置为 SQL_SS_TABLE）的序数时可用。 有关SQL_SOPT_SS_PARAM_FOCUS的详细信息，请参阅 SQLSetStmtAttr。

如果尝试将SQL_SOPT_SS_PARAM_FOCUS设置为非表值参数的参数序号，SQLSetStmtAttr 将返回SQL_ERROR，并使用 SQLSTATE = HY024 和消息“无效属性值”创建诊断记录。 返回 SQL_ERROR 时，不更改 SQL_SOPT_SS_PARAM_FOCUS。

将 SQL_SOPT_SS_PARAM_FOCUS 设置为 0 可以恢复对参数的描述符记录的访问权限。

有关表值参数的详细信息，请参阅表值参数（ODBC）。

SQLSetDescField 对日期和时间增强功能的支持

ODBC 中已增强了日期/时间功能。 有关为新日期/时间类型提供的描述符字段的信息，请参阅 参数和结果元数据。

有关详细信息，请参阅日期和时间改进（ODBC）。

SQLSetDescField 对大型 CLR UDT 的支持

SQLSetDescField 支持大型 CLR 用户定义类型（UDT）。 有关详细信息，请参阅大型 CLR 用户定义的类型（ODBC）。

SQLSetDescField 对稀疏列的支持

SQLSetDecField 可用于将应用程序参数描述符（APD）中的SQL_SOPT_SS_NAME_SCOPE设置为SQL_SS_NAME_SCOPE_EXTENDED和SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET的值。

有关详细信息，请参阅稀疏列支持（ODBC）。

另请参阅

SQLSetDescField
ODBC API 实现细节