SQLGetDescRec
Dotyczy:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
W tym temacie omówiono funkcje SQLGetDescRec specyficzne dla klienta natywnego programu SQL Server.
Parametry SQLGetDescRec i Table-Valued
Funkcja SQLGetDescRec może służyć do pobierania wartości atrybutów parametrów z wartościami tabeli i kolumn parametrów wartości tabeli. Parametr RecNumber sqlGetDescRec odpowiada parametrowi ParameterNumber parametru SQLBindParameter.
Kolumny parametrów wartości tabeli są dostępne tylko wtedy, gdy pole nagłówka deskryptora SQL_SOPT_SS_PARAM_FOCUS jest ustawione na porządkowe rekordu, który SQL_DESC_TYPE ustawiony na SQL_SS_TABLE. Aby uzyskać więcej informacji na temat SQL_SOPT_SS_PARAM_FOCUS, zobacz SQLSetStmtAttr.
Funkcja SQLGetDescRec zwraca następujące dane:
| Parametr | Parametr z wartością tabeli | Kolumny parametrów z wartością tabeli i inne parametry |
|---|---|---|
| nazwa | Formalna nazwa parametru wywołania procedury składowanej; w przeciwnym razie ciąg o długości 0. | Nazwa kolumny parametru wartości tabeli. |
| TypePtr | SQL_DESC_TYPE. W przypadku parametrów o wartości tabeli jest to SQL_SS_TABLE. | SQL_DESC_TYPE |
| subTypePtr |
Niezdefiniowany | SQL_DESC_DATETIME_INTERVAL_CODE (w przypadku rekordów typu SQL_DATETIME lub SQL_INTERVAL). |
| |
0 | SQL_DESC_OCTET_LENGTH |
| PrecisionPtr | 0 | SQL_DESC_PRECISION |
| |
0 | SQL_DESC_SCALE |
| |
1 | SQL_DESC_NULLABLE |
Aby uzyskać więcej informacji na temat parametrów wartości tabeli, zobacz Table-Valued Parameters (ODBC).
SQLGetDescRec — obsługa rozszerzonych funkcji daty i godziny
Wartości zwracane dla typów daty/godziny są następujące:
| Atrybut | TypePtr | subTypePtr |
|
PrecisionPtr | |
|---|---|---|---|---|---|
| data/godzina | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| data | SQL_DATETIME | SQL_CODE_DATE | 6 | 0 | 0 |
| Godzina | SQL_SS_TIME2 | 0 | 10 | 0..7 | 0..7 |
| data/godzina2 | SQL_DATETIME | SQL_CODE_TIMESTAMP | 16 | 0..7 | 0..7 |
| datetimeoffset | SQL_SS_TIMESTAMPOFFSET | 0 | 20 | 0..7 | 0..7 |
Aby uzyskać więcej informacji, zobacz ulepszenia daty i godziny (ODBC).
SQLGetDescRec — obsługa dużych identyfikatorów ZDEFINIOWANYch przez użytkownika CLR
SQLGetDescRec obsługuje duże typy zdefiniowane przez użytkownika (UDT). Aby uzyskać więcej informacji, zobacz large CLR User-Defined Types (ODBC).
Zobacz też
SQLGetDescRec
szczegóły implementacji interfejsu API ODBC