Parâmetro e metadados de resultado

Informações retornadas nos campos IPD

As seguintes informações são retornadas nos campos IPD:

Às vezes, há descontinuações em intervalos de valores. Por exemplo, 9 está ausente em 8,10.. 16. Isso se deve à adição de um ponto decimal quando a precisão fracionária é maior que zero.

datetime2 é retornado como typename para smalldatetime e datetime porque o driver usa esse tipo como um mesmo tipo para transmitir todos os valores SQL_TYPE_TIMESTAMP para o servidor.

SQL_CA_SS_VARIANT_SQL_TYPE é um novo campo descritor. Esse campo foi adicionado a IRD e IPD para permitir que os aplicativos especifiquem o tipo de valor associado a colunas e parâmetros sqlvariant (SQL_SSVARIANT)

SQL_CA_SS_SERVER_TYPE é um novo campo somente IPD que permite aos aplicativos controlar como os valores de parâmetros associados como SQL_TYPE_TYPETIMESTAMP (ou como SQL_SS_VARIANT com um tipo C de SQL_C_TYPE_TIMESTAMP) são enviados para o servidor. Caso SQL_DESC_CONCISE_TYPE seja SQL_TYPE_TIMESTAMP (ou seja SQL_SS_VARIANT e o tipo C seja SQL_C_TYPE_TIMESTAMP) quando SQLExecute ou SQLExecDirect é chamado, o valor de SQL_CA_SS_SERVER_TYPE determina o tipo do protocolo TDS do valor de parâmetro da seguinte forma:

A configuração padrão de SQL_CA_SS_SERVER_TYPE é SQL_SS_TYPE_DEFAULT. As configurações de SQL_DESC_PRECISION e SQL_DESC_LENGTH são validadas com a configuração de SQL_CA_SS_SERVER_TYPE, conforme descrição na tabela acima. Caso essa validação falhe, SQL_ERROR é retornado, e um registro de diagnóstico é feito com SQLState 07006 e a mensagem "Violação do atributo de tipo de dados restrito". Esse erro também é retornado caso SQL_CA_SS_SERVER_TYPE seja definido como um valor diferente de SQL_SS_TYPE DEFAULT e DESC_CONCISE_TYPE não seja SQL_TYPE_TIMESTAMP. Essas validações são executadas quando ocorre a validação de consistência do descritor. Por exemplo:

• Quando SQL_DESC_DATA_PTR é alterado.

• No momento da preparação ou da execução (quando SQLExecute, SQLExecDirect, SQLSetPos ou SQLBulkOperations é chamado).

• Quando um aplicativo força uma preparação não adiada chamando SQLPrepare com a preparação adiada habilitada, ou chamando SQLNumResultCols, SQLDescribeCol ou SQLDescribeParam para uma instrução preparada, mas não executada.

Quando SQL_CA_SS_SERVER_TYPE é definido por uma chamada para SQLSetDescField, o valor deve ser SQL_SS_TYPE_DEFAULT, SQL_SS_TYPE_SMALLDATETIME ou SQL_SS_TYPE_DATETIME. Caso não seja esse o caso, SQL_ERROR é retornado, e um registro de diagnóstico é feito com SQLState HY092 e a mensagem "Identificador de atributo/opção inválido".

O atributo SQL_CA_SS_SERVER_TYPE pode ser usado por aplicativos que dependem da funcionalidade para a qual datetime e smalldatetime oferecem suporte, mas não datetime2. Por exemplo, datetime2 exige o uso das funções dateadd e datediif, e datetime e smalldatetime também permitem operadores aritméticos. A maioria dos aplicativos não precisará usar esse atributo, e seu uso deve ser evitado.

Informações retornadas nos campos IRD

As seguintes informações são retornadas nos campos IRD:

Consulte também

Conceitos