Compartilhar via


SQLSetDescField

SQLSetDescField pode ser usado para definir campos de descritor para parâmetros com valor de tabela e colunas de parâmetro com valor de tabela. Para obter informações sobre os campos disponíveis, consulte Table-Valued campos de descritor de parâmetro e campos de descritor de parâmetro para colunas constituintes do parâmetro Table-Valued.

Observações

As colunas do parâmetro com valor de tabela ficam disponíveis somente quando o campo do cabeçalho do descritor SQL_SOPT_SS_PARAM_FOCUS é definido como o ordinal de um registro que tenha SQL_DESC_TYPE definido como SQL_SS_TABLE. Para obter 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 é um parâmetro com valor de tabela, SQLSetStmtAttr retornará SQL_ERROR e um registro de diagnóstico será criado com SQLSTATE = HY024 e a mensagem "Valor de atributo inválido". SQL_SOPT_SS_PARAM_FOCUS não é alterado quando SQL_ERROR é retornado.

Definir SQL_SOPT_SS_PARAM_FOCUS como 0 restaura o acesso aos registros de descritor para parâmetros.

Para obter mais informações sobre parâmetros com valor de tabela, consulte ODBC (Parâmetros com valor de tabela).

Suporte do SQLSetDescField para recursos avançados de data e hora

Os recursos de data/hora foram aprimorados no ODBC. Para obter 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 UDTs CLR grandes

SQLSetDescField dá suporte a grandes UDTs (tipos definidos pelo usuário) CLR. Para obter mais informações, consulte ODBC (Tipos Definidos pelo Usuário) CLR Grandes.

Suporte sqlSetDescField para colunas esparsas

SQLSetDecField pode ser usado para definir SQL_SOPT_SS_NAME_SCOPE no APD (descritor de parâmetro de aplicativo) para os valores SQL_SS_NAME_SCOPE_EXTENDED e SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET.

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

Consulte Também

SQLSetDescField
Detalhes da implementação da API do ODBC