다음을 통해 공유


SQLGetDescRec

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics 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 지원

날짜/시간 형식에 대해 반환되는 값은 다음과 같습니다.

특성 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 사용자 정의 형식)를 참조하세요.

참고 항목

SQLGetDescRec
ODBC API 구현 정보