SQLSetDescField

  • 项目

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

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

备注

表值参数列仅在将描述符标头字段 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 User-Defined类型 (ODBC) 。

SQLSetDescField 对稀疏列的支持

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

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

另请参阅

SQLSetDescField
ODBC API 实现细节