SQLSetDescField

적용 대상: SQL Server(지원되는 모든 버전) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

SQLSetDescField를 사용하여 테이블 반환 매개 변수 및 테이블 반환 매개 변수 열에 대한 설명자 필드를 설정할 수 있습니다. 사용 가능한 필드에 대한 자세한 내용은 Table-Valued 매개 변수 구성 열에 대한 테이블 반환 매개 변수 설명자 필드 및 설명자 필드를 참조하세요.

설명

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

테이블 반환 매개 변수가 아닌 매개 변수의 서수로 SQL_SOPT_SS_PARAM_FOCUS 설정하려는 경우 SQLSetStmtAttr는 SQL_ERROR 반환하고 SQLSTATE = HY024 및 "잘못된 특성 값"이라는 메시지를 사용하여 진단 레코드를 만듭니다. SQL_SOPT_SS_PARAM_FOCUS는 SQL_ERROR가 반환될 때 변경되지 않습니다.

SQL_SOPT_SS_PARAM_FOCUS를 0으로 설정하면 매개 변수의 설명자 레코드에 대한 액세스가 복원됩니다.

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

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

ODBC에서 날짜/시간 기능이 향상되었습니다. 새로운 날짜/시간 형식에 제공되는 설명자 필드에 대한 자세한 내용은 Parameter and Result Metadata를 참조하십시오.

자세한 내용은 날짜 및 시간 개선 사항(ODBC)을 참조하세요.

큰 CLR UDT에 대한 SQLSetDescField 지원

SQLSetDescField는 큰 CLR UT(사용자 정의 형식)를 지원합니다. 자세한 내용은 큰 CLR User-Defined 형식(ODBC)을 참조하세요.

스파스 열에 대한 SQLSetDescField 지원

SQLSetDecField를 사용하여 APD(애플리케이션 매개 변수 설명자)의 SQL_SOPT_SS_NAME_SCOPE SQL_SS_NAME_SCOPE_EXTENDED 및 SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET 값으로 설정할 수 있습니다.

자세한 내용은 스파스 열 지원(ODBC)을 참조하세요.

참고 항목

SQLSetDescField
ODBC API 구현 정보