Partilhar via


SQLGetDescRec

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

SQLGetDescRec retorna os dados a seguir:

Parâmetro

Parâmetro com valor de tabela

Colunas de parâmetro com valor de tabela e outros parâmetros

Name

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.

TypePtr

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.)

LengthPtr

0

SQL_DESC_OCTET_LENGTH

PrecisionPtr

0

SQL_DESC_PRECISION

ScalePtr

0

SQL_DESC_SCALE

NullablePtr

1

SQL_DESC_NULLABLE

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

Suporte de SQLGetDescRec a recursos aprimorados de data e hora

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

TypePtr

SubTypePtr

LengthPtr

PrecisionPtr

ScalePtr

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

hora

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 Aprimoramentos de data/hora (ODBC).

Suporte de SQLGetDescRec para UDTs CLR grandes

SQLGetDescRec oferece suporte a tipos de dados CLR grandes definidos pelo usuário. Para obter mais informações, consulte Tipos de dados CLR grandes definidos pelo usuário (ODBC).

Consulte também

Conceitos

Outros recursos