SQLSetDescField

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse Analytics

O SQLSetDescField pode ser usado para definir campos de descrição para parâmetros com valores em tabela e colunas de parâmetros com valores em tabelas. Para informações sobre os campos disponíveis, vejaTable-Valued Campos Descritores de Parâmetro e Campos de Descritores para Table-Valued Colunas de Constituintes de Parâmetros.

Observações

Colunas de parâmetros com valores de tabela só estão disponíveis quando o campo de cabeçalho do descritor SQL_SOPT_SS_PARAM_FOCUS está definido para o ordinal de um registo que tem SQL_DESC_TYPE definido para SQL_SS_TABLE. Para mais informações sobre SQL_SOPT_SS_PARAM_FOCUS, consulte SQLSetStmtAttr.

Se for feita uma tentativa de definir SQL_SOPT_SS_PARAM_FOCUS para o ordinal de um parâmetro que não seja um parâmetro com valores de tabela, SQLSetStmtAttr devolve SQL_ERROR, e é criado um registo de diagnóstico com SQLSTATE = HY024 e a mensagem "Valor do atributo inválido". SQL_SOPT_SS_PARAM_FOCUS não é alterado quando SQL_ERROR é devolvido.

Definir SQL_SOPT_SS_PARAM_FOCUS para 0 restaura o acesso aos registos de descritores para parâmetros.

Para mais informações sobre parâmetros com valores de tabela, veja Table-Valued Parâmetros (ODBC).

Suporte SQLSetDescField para funcionalidades melhoradas de data e hora

As funcionalidades de data/hora foram melhoradas no ODBC. Para informações sobre o campo descritor fornecido para os novos tipos de data/hora, consulte Metadados de Parâmetro e Resultado.

Para obter mais informações, consulte Melhorias de data e hora (ODBC).

Suporte SQLSetDescField para grandes CLR UDTs

O SQLSetDescField suporta grandes tipos CLR definidos pelo utilizador (UDTs). Para obter mais informações, consulte Large CLR User-Defined Types (ODBC).

Suporte SQLSetDescField para colunas esparsas

O SQLSetDecField pode ser usado para definir SQL_SOPT_SS_NAME_SCOPE no descritor de parâmetros de aplicação (APD) para os valores SQL_SS_NAME_SCOPE_EXTENDED e SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET.

Para mais informações, consulte Suporte a Colunas Escassas (ODBC).