SQLGetDescRec
van toepassing op:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
In dit onderwerp wordt de sqlGetDescRec-functionaliteit besproken die specifiek is voor SQL Server Native Client.
SQLGetDescRec- en Table-Valued-parameters
SQLGetDescRec kan worden gebruikt om waarden op te halen voor kenmerken van parameters met tabelwaarden en kolommen met parameters met tabelwaarden. De parameter RecNumber van SQLGetDescRec komt overeen met de parameter ParameterNumber van SQLBindParameter.
Tabelwaardeparameterkolommen zijn alleen beschikbaar wanneer het veld voor de beschrijvingskoptekst SQL_SOPT_SS_PARAM_FOCUS is ingesteld op het rangtelwoord van een record waarop SQL_DESC_TYPE is ingesteld op SQL_SS_TABLE. Zie SQLSetStmtAttrvoor meer informatie over SQL_SOPT_SS_PARAM_FOCUS.
SQLGetDescRec retourneert de volgende gegevens:
| Parameter | Parameter met tabelwaarde | Kolommen met parameters met tabelwaarden en andere parameters |
|---|---|---|
| naam | De formele parameternaam voor een opgeslagen procedure-aanroep; anders een tekenreeks van 0 lengte. | De kolomnaam van de parameter met tabelwaarden. |
| TypePtr- | SQL_DESC_TYPE. Voor parameters met tabelwaarden is dit SQL_SS_TABLE. | SQL_DESC_TYPE |
| SubTypePtr- | Ongedefinieerde | SQL_DESC_DATETIME_INTERVAL_CODE (voor records van het type SQL_DATETIME of SQL_INTERVAL.) |
| LengthPtr- | 0 | SQL_DESC_OCTET_LENGTH |
| PrecisionPtr- | 0 | SQL_DESC_PRECISION |
| ScalePtr- | 0 | SQL_DESC_SCALE |
| NullablePtr- | 1 | SQL_DESC_NULLABLE |
Zie Table-Valued Parameters (ODBC)voor meer informatie over parameters met tabelwaarden.
SQLGetDescRec-ondersteuning voor verbeterde datum- en tijdfuncties
De waarden die worden geretourneerd voor datum-/tijdtypen zijn als volgt:
| Attribuut | TypePtr- | SubTypePtr- | LengthPtr- | PrecisionPtr- | ScalePtr- |
|---|---|---|---|---|---|
| datum/tijd | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| datum | SQL_DATETIME | SQL_CODE_DATE | 6 | 0 | 0 |
| Tijd | 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 |
Zie ODBC-(Datum- en tijdverbeteringen) voor meer informatie.
SQLGetDescRec-ondersteuning voor grote CLR-UDT's
SQLGetDescRec- ondersteunt grote door de gebruiker gedefinieerde CLR-typen (UDT's). Zie ODBC-(Large CLR User-Defined Types) voor meer informatie.