SQLSetDescRec 함수

규칙
도입된 버전: ODBC 3.0 표준 준수: ISO 92

요약
SQLSetDescRec 함수는 열 또는 매개 변수 데이터에 바인딩된 데이터 형식 및 버퍼에 영향을 주는 여러 설명자 필드를 설정합니다.

통사론

  
SQLRETURN SQLSetDescRec(  
      SQLHDESC      DescriptorHandle,  
      SQLSMALLINT   RecNumber,  
      SQLSMALLINT   Type,  
      SQLSMALLINT   SubType,  
      SQLLEN        Length,  
      SQLSMALLINT   Precision,  
      SQLSMALLINT   Scale,  
      SQLPOINTER    DataPtr,  
      SQLLEN *      StringLengthPtr,  
      SQLLEN *      IndicatorPtr);  

인수

DescriptorHandle
[입력] 설명자 핸들입니다. IRD 핸들이 아니어야 합니다.

RecNumber
[입력] 설정할 필드가 포함된 설명자 레코드를 나타냅니다. 설명자 레코드는 0부터 번호가 매겨지고 레코드 번호 0은 책갈피 레코드입니다. 이 인수는 0보다 크거나 같아야 합니다. RecNumber SQL_DESC_COUNT 값보다 크면 SQL_DESC_COUNTis RecNumber값으로 변경됩니다.

형식
[입력] 설명자 레코드의 SQL_DESC_TYPE 필드를 설정할 값입니다.

하위 형식
[입력] 형식이 SQL_DATETIME 또는 SQL_INTERVAL 레코드의 경우 SQL_DESC_DATETIME_INTERVAL_CODE 필드를 설정할 값입니다.

길이
[입력] 설명자 레코드의 SQL_DESC_OCTET_LENGTH 필드를 설정할 값입니다.

전체 자릿수
[입력] 설명자 레코드의 SQL_DESC_PRECISION 필드를 설정할 값입니다.

크기 조정
[입력] 설명자 레코드의 SQL_DESC_SCALE 필드를 설정할 값입니다.

DataPtr
[지연된 입력 또는 출력] 설명자 레코드의 SQL_DESC_DATA_PTR 필드를 설정할 값입니다. DataPtr null 포인터로 설정할 수 있습니다.

DataPtr 인수를 null 포인터로 설정하여 SQL_DESC_DATA_PTR 필드를 null 포인터로 설정할 수 있습니다. DescriptorHandle 인수의 핸들이 ARD와 연결된 경우 열을 바인딩 해제합니다.

StringLengthPtr
[지연된 입력 또는 출력] 설명자 레코드의 SQL_DESC_OCTET_LENGTH_PTR 필드를 설정할 값입니다. StringLengthPtr null 포인터로 설정하여 SQL_DESC_OCTET_LENGTH_PTR 필드를 null 포인터로 설정할 수 있습니다.

IndicatorPtr
[지연된 입력 또는 출력] 설명자 레코드의 SQL_DESC_INDICATOR_PTR 필드를 설정할 값입니다. IndicatorPtr null 포인터로 설정하여 SQL_DESC_INDICATOR_PTR 필드를 null 포인터로 설정할 수 있습니다.

반환

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR 또는 SQL_INVALID_HANDLE.

진단

SQLSetDescRec SQL_ERROR 또는 SQL_SUCCESS_WITH_INFO 반환하는 경우 SQL_HANDLE_DESC HandleTypeSQLGetDiagRec 호출하고 DescriptorHandle핸들 호출하여 관련 SQLSTATE 값을 가져올 수 있습니다. 다음 표에서는 SQLSetDescRec 일반적으로 반환되는 SQLSTATE 값을 나열하고 이 함수의 컨텍스트에서 각각에 대해 설명합니다. "(DM)" 표기법은 드라이버 관리자가 반환한 SQLSTATE에 대한 설명 앞에 섰습니다. 달리 명시되지 않는 한 각 SQLSTATE 값과 연결된 반환 코드는 SQL_ERROR.

코멘트

애플리케이션은 SQLSetDescRec 호출하여 단일 열 또는 매개 변수에 대해 다음 필드를 설정할 수 있습니다.

• SQL_DESC_TYPE

• SQL_DESC_DATETIME_INTERVAL_CODE(형식이 SQL_DATETIME 또는 SQL_INTERVAL 레코드의 경우)

• SQL_DESC_OCTET_LENGTH

• SQL_DESC_PRECISION

• SQL_DESC_SCALE

• SQL_DESC_DATA_PTR

• SQL_DESC_OCTET_LENGTH_PTR

• SQL_DESC_INDICATOR_PTR

열 또는 매개 변수를 바인딩할 때 SQLSetDescRec 사용하면 SQLBindCol 호출하거나 SQLBindParameter SQLSetDescField여러 호출하지 않고 바인딩에 영향을 주는 여러 필드를 변경할 수 있습니다. SQLSetDescRec 현재 문과 연결되지 않은 설명자에 필드를 설정할 수 있습니다. SQLBindParameterSQLSetDescRec보다 더 많은 필드를 설정하고 APD와 IPD 둘 다에서 한 번의 호출로 필드를 설정할 수 있으며 설명자 핸들이 필요하지 않습니다.

일관성 검사

애플리케이션이 APD, ARD 또는 IPD의 SQL_DESC_DATA_PTR 필드를 설정하면 드라이버에서 일관성 검사를 자동으로 수행합니다. 필드가 다른 필드와 일치하지 않으면 SQLSetDescRec SQLSTATE HY021(일관성 없는 설명자 정보)을 반환합니다.

애플리케이션이 APD, ARD 또는 IPD의 SQL_DESC_DATA_PTR 필드를 설정할 때마다 드라이버는 SQL_DESC_TYPE 필드의 값과 해당 SQL_DESC_TYPE 필드에 적용할 수 있는 값이 유효하고 일관적인지 확인합니다. 이 검사는 SQLBindParameter 또는 SQLBindCol 호출되거나 APD, ARD 또는 IPD에 대해 SQLSetDescRec 호출될 때 항상 수행됩니다. 이 일관성 검사에는 설명자 필드에 대한 다음 검사가 포함됩니다.

• SQL_DESC_TYPE 필드는 유효한 ODBC C 또는 SQL 형식 또는 드라이버별 SQL 형식 중 하나여야 합니다. SQL_DESC_CONCISE_TYPE 필드는 간결한 날짜/시간 및 간격 형식을 포함하여 유효한 ODBC C 또는 SQL 형식 또는 드라이버별 C 또는 SQL 형식 중 하나여야 합니다.

• SQL_DESC_TYPE 레코드 필드가 SQL_DATETIME 또는 SQL_INTERVAL 경우 SQL_DESC_DATETIME_INTERVAL_CODE 필드는 유효한 날짜/시간 또는 간격 코드 중 하나여야 합니다. (SQLSetDescFieldSQL_DESC_DATETIME_INTERVAL_CODE 필드에 대한 설명을 참조하세요.)

• SQL_DESC_TYPE 필드에 숫자 형식이 표시되면 SQL_DESC_PRECISION 및 SQL_DESC_SCALE 필드가 유효한 것으로 확인됩니다.

• SQL_DESC_CONCISE_TYPE 필드가 시간 또는 타임스탬프 데이터 형식, 초 구성 요소가 있는 간격 형식 또는 시간 구성 요소가 있는 간격 데이터 형식 중 하나인 경우 SQL_DESC_PRECISION 필드는 유효한 초 정밀도로 확인됩니다.

• SQL_DESC_CONCISE_TYPE 간격 데이터 형식인 경우 SQL_DESC_DATETIME_INTERVAL_PRECISION 필드가 올바른 간격 선행 전체 자릿수 값으로 확인됩니다.

IPD의 SQL_DESC_DATA_PTR 필드는 일반적으로 설정되지 않습니다. 그러나 애플리케이션은 IPD 필드의 일관성 검사를 강제로 수행할 수 있습니다. IRD에서는 일관성 검사를 수행할 수 없습니다. IPD의 SQL_DESC_DATA_PTR 필드가 설정된 값은 실제로 저장되지 않으며 SQLGetDescField 또는 SQLGetDescRec호출로 검색할 수 없습니다. 이 설정은 일관성 검사를 강제로 적용하기 위해서만 이루어집니다.

관련 함수

참고 항목

ODBC API 참조
ODBC 헤더 파일