다음을 통해 공유


SQLSetDescRec

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

이 항목에서는 SQL Server Native Client와 관련된 SQLSetDescRec 기능에 대해 설명합니다.

SQLSetDescRec 및 테이블 반환 매개 변수

SQLSetDescRec를 사용하여 테이블 반환 매개 변수 및 테이블 반환 매개 변수 열에 대한 설명자 필드를 설정할 수 있습니다. 테이블 반환 매개 변수 열은 설명자 헤더 필드 SQL_SOPT_SS_PARAM_FOCUS가 SQL_DESC_TYPE이 SQL_SS_TABLE로 설정된 레코드의 서수로 설정된 경우에만 사용할 수 있습니다. SQL_SOPT_SS_PARAM_FOCUS 대한 자세한 내용은 SQLSetStmtAttr을 참조 하세요.

다음 표에서는 매개 변수와 설명자 필드 간의 매핑에 대해 설명합니다.

매개 변수 테이블 반환 매개 변수 열을 포함하여 테이블 반환이 아닌 매개 변수 형식에 대한 관련 특성 테이블 반환 매개 변수에 대한 관련 특성
Type SQL_DESC_TYPE SQL_SS_TABLE
SubType 무시됨 형식 SQL_DATETIME 또는 SQL_INTERVAL 레코드의 경우 SQL_DESC_DATETIME_INTERVAL_CODE 설정합니다.
길이 SQL_DESC_OCTET_LENGTH 테이블 반환 매개 변수 형식 이름의 길이입니다. 형식 이름이 null로 종료된 경우 SQL_NTS, 테이블 반환 매개 변수 형식 이름이 필요하지 않은 경우 0일 수 있습니다.
정밀도 SQL_DESC_PRECISION SQL_DESC_ARRAY_SIZE
스케일 SQL_DESC_SCALE 사용되지 않습니다. 이 매개 변수는 0이어야 합니다.
DataPtr APD의 SQL_DESC_DATA_PTR SQL_CA_SS_TYPE_NAME

이 매개 변수는 저장 프로시저 호출에 대해 선택 사항이며, 필요하지 않은 경우 NULL을 지정할 수 있습니다. 프로시저 호출이 아닌 SQL 문에 대해 이 매개 변수를 지정해야 합니다.

또한 DataPtr 은 변수 행 바인딩을 사용할 때 애플리케이션에서 이 테이블 반환 매개 변수를 식별하는 데 사용할 수 있는 고유한 값으로 사용됩니다.
StringLengthPtr SQL_DESC_OCTET_LENGTH_PTR SQL_DESC_OCTET_LENGTH_PTR

테이블 반환 매개 변수의 경우 이 값은 전송할 행 수나 SQL_DATA_AT_EXEC입니다. SQLExecDirect를 사용하여 전송할 행 수를 보유하는 값에 대한 포인터입니다.
IndicatorPtr SQL_DESC_INDICATOR_PTR SQL_DESC_INDICATOR_PTR

테이블 반환 매개 변수에 대한 자세한 내용은 ODBC(테이블 반환 매개 변수)를 참조하세요.

향상된 날짜 및 시간 기능에 대한 SQLSetDescRec 지원

날짜/시간 형식에 허용되는 값은 다음과 같습니다.

특성 Type SubType 길이 정밀도 스케일
날짜/시간 SQL_DATETIME SQL_CODE_TIMESTAMP 4 3 3
smalldatetime SQL_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에 대한 SQLSetDescRec 지원

SQLSetDescRec 는 큰 CLR UDT(사용자 정의 형식)를 지원합니다. 자세한 내용은 ODBC(큰 CLR 사용자 정의 형식)를 참조하세요.

참고 항목

SQLSetDescRec
ODBC API 구현 정보