SQLGetDescRec

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Este tópico discute a funcionalidade SQLGetDescRec específica do SQL Server Native Client.

SQLGetDescRec e parâmetros com valor de tabela

SQLGetDescRec pode ser usado para obter valores para atributos de parâmetros com valor de tabela e colunas de parâmetro com valor de tabela. O parâmetro RecNumber de SQLGetDescRec corresponde ao parâmetro ParameterNumber de SQLBindParameter.

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 sobre, consulte SQLSetStmtAttr.

SQLGetDescRec retorna os seguintes dados:

Parâmetro Parâmetro com valor de tabela Colunas de parâmetro com valor de tabela e outros parâmetros
Nome O nome de parâmetro formal para uma chamada de procedimento armazenado; caso contrário, uma cadeia de caracteres de comprimento 0. O nome da coluna do parâmetro com valor de tabela.
TipoPtr SQL_DESC_TYPE. Para parâmetros com valor de tabela, este é SQL_SS_TABLE. SQL_DESC_TYPE
SubTypePtr Indefinido SQL_DESC_DATETIME_INTERVAL_CODE (Para registros do tipo SQL_DATETIME ou SQL_INTERVAL.)
ComprimentoPtr 0 SQL_DESC_OCTET_LENGTH
PrecisãoPtr 0 SQL_DESC_PRECISION
EscalaPtr 0 SQL_DESC_SCALE
NullablePtr 1 SQL_DESC_NULLABLE

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

Suporte de SQLGetDescRec a recursos aprimorados de data e hora

Os valores retornados para tipos de data/hora são os seguintes:

Atributo TipoPtr SubTypePtr ComprimentoPtr PrecisãoPtr EscalaPtr
datetime SQL_DATETIME SQL_CODE_TIMESTAMP 4 3 3
smalldatetime SQL_DATETIME SQL_CODE_TIMESTAMP 8 0 0
date SQL_DATETIME SQL_CODE_DATE 6 0 0
time SQL_SS_TIME2 0 10 0..7 0..7
datetime2 SQL_DATETIME SQL_CODE_TIMESTAMP 16 0..7 0..7
datetimeoffset SQL_SS_TIMESTAMPOFFSET 0 20 0..7 0..7

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

Suporte de SQLGetDescRec para UDTs CLR grandes

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

Confira também

SQLGetDescRec
Detalhes da implementação da API do ODBC