SQLGetDescRec
Este tópico discute a funcionalidade SQLGetDescRec específica para 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, 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. |
| 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 Melhorias de data e hora (ODBC).
Suporte de SQLGetDescRec para UDTs CLR grandes
SQLGetDescRec dá suporte a UDTs grandes do CLR. Para obter mais informações, consulte Tipos de User-Defined clr grandes (ODBC).