SQLSetDescRec

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform 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	길이	정밀도	스케일
Datetime	SQL_DATETIME	SQL_CODE_TIMESTAMP	4	3	3
smalldatetime	SQL_SQL_DATETIME	SQL_CODE_TIMESTAMP	8	0	0
날짜	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 구현 정보