SQLGetDescRec
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)
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, isso é 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.