SQLGetDescRec
Este tópico discute a funcionalidade SQLGetDescRec específica do SQL Server Native Client.
Parâmetros SQLGetDescRec e Table-Valued
SQLGetDescRec pode ser usado para obter valores para atributos de parâmetros com valor de tabela e colunas de parâmetros com valor de tabela. O parâmetro RecNumber de SQLGetDescRec corresponde ao parâmetro ParameterNumber de SQLBindParameter.
As colunas de parâmetros com valor de tabela só estão disponíveis quando o campo de cabeçalho do descritor SQL_SOPT_SS_PARAM_FOCUS é definido como o ordinal de um registro que 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âmetros com valor de tabela e outros parâmetros |
|---|---|---|
| Nome | O nome do 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, isso é SQL_SS_TABLE. | SQL_DESC_TYPE |
| SubTypePtr | Indefinido | SQL_DESC_DATETIME_INTERVAL_CODE (Para registos 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 Table-Valued (ODBC).
Suporte SQLGetDescRec para recursos aprimorados de data e hora
Os valores retornados para tipos de data/hora são os seguintes:
| Atributo | TypePtr | SubTypePtr | LengthPtr | PrecisionPtr | ScalePtr |
|---|---|---|---|---|---|
| datetime | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| PequenoDateTime | SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| data | 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 Melhorias de data e hora (ODBC).
Suporte SQLGetDescRec para UDTs CLR grandes
SQLGetDescRec suporta grandes tipos CLR definidos pelo usuário (UDTs). Para obter mais informações, consulte Large CLR User-Defined Types (ODBC).