SQLGetDescRec
적용 대상: SQL ServerAzure SQL 데이터베이스Azure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System(PDW)
이 항목에서는 SQL Server Native Client와 관련된 SQLGetDescRec 기능에 대해 설명합니다.
SQLGetDescRec 및 테이블 반환 매개 변수
SQLGetDescRec를 사용하여 테이블 반환 매개 변수 및 테이블 반환 매개 변수 열의 특성 값을 가져올 수 있습니다. SQLGetDescRec의 RecNumber 매개 변수는 SQLBindParameter의 ParameterNumber 매개 변수에 해당합니다.
테이블 반환 매개 변수 열은 설명자 헤더 필드 SQL_SOPT_SS_PARAM_FOCUS가 SQL_DESC_TYPE이 SQL_SS_TABLE로 설정된 레코드의 서수로 설정된 경우에만 사용할 수 있습니다. SQL_SOPT_SS_PARAM_FOCUS 대한 자세한 내용은 SQLSetStmtAttr을 참조하세요.
SQLGetDescRec는 다음 데이터를 반환합니다.
매개 변수 | 테이블 반환 매개 변수 | 테이블 반환 매개 변수 열 및 기타 매개 변수 |
---|---|---|
이름 | 저장 프로시저 호출의 정식 매개 변수 이름입니다. 그렇지 않으면 길이가 0인 문자열입니다. | 테이블 반환 매개 변수 열 이름입니다. |
TypePtr | SQL_DESC_TYPE. 테이블 반환 매개 변수의 경우 SQL_SS_TABLE. | SQL_DESC_TYPE |
SubTypePtr | Undefined | SQL_DESC_DATETIME_INTERVAL_CODE(형식 SQL_DATETIME 또는 SQL_INTERVAL 레코드의 경우) |
LengthPtr | 0 | SQL_DESC_OCTET_LENGTH |
PrecisionPtr | 0 | SQL_DESC_PRECISION |
ScalePtr | 0 | SQL_DESC_SCALE |
NullablePtr | 1 | SQL_DESC_NULLABLE |
테이블 반환 매개 변수에 대한 자세한 내용은 ODBC(테이블 반환 매개 변수)를 참조하세요.
향상된 날짜 및 시간 기능에 대한 SQLGetDescRec 지원
날짜/시간 형식에 대해 반환되는 값은 다음과 같습니다.
attribute | TypePtr | SubTypePtr | LengthPtr | PrecisionPtr | ScalePtr |
---|---|---|---|---|---|
날짜/시간 | 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 |
자세한 내용은 날짜 및 시간 개선 사항(ODBC)을 참조하세요.
큰 CLR UDT에 대한 SQLGetDescRec 지원
SQLGetDescRec 는 큰 CLR UDT(사용자 정의 형식)를 지원합니다. 자세한 내용은 ODBC(큰 CLR 사용자 정의 형식)를 참조하세요.