SQLGetDescRec
Este tópico discute a funcionalidade SQLGetDescRec que é específico 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 SQLGetDecRec 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 |
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 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).