콘텐츠로 이동

SQLGetDescField

SQLGetDescField#

descriptor의 속성을 한 개 가져온다.

Unicode SQLGetDescFieldW() 동작은 SQLGetDescField()와 동일하다.

구 문#

SQLRETURN SQLGetDescField (
    SQLHDESC    desc,
    SQLSMALLINT recNumber,
    SQLSMALLINT fieldIdentifier,
    SQLPOINTER ValuePtr,
    SQLINTEGER *bufferLength,
    SQLINTEGER *stringLengthPtr);

인 자#

자료유형 인자 사용 설명
SQLHDESC desc 입력 descriptor 핸들
SQLSMALLINT recNumber 입력 칼럼번호 1부터 시작
SQLSMALLINT fieldIdentifier 입력 가져올 칼럼의 속성을 지정
SQLPOINTER ValuePtr 출력 속성을 저장할 버퍼 포인터
SQLINTEGER * bufferLength 입력 ValuePtr의 크기
SQLINTEGER * stringLengthPtr 출력 ValuePtr 에 저장된 크기

결괏값#

SQL_SUCCESS
SQL_SUCCESS_WITH_INFO
SQL_NO_DATA
SQL_INVALID_HANDLE
SQL_ERROR

설 명#

descriptor 핸들을 이용해서 칼럼의 정보들을 한 개 가져올 수 있다.

진 단#

SQLSTATE 설명 부연설명
HY000 일반 오류 명시적인 오류 발생 없음
HY001 메모리 할당 오류 명시된 핸들을 위한 메모리 할당에 실패함.
HY010 함수 호출 순서 오류
01004 자료가 잘림 ValuePtr 버퍼의 크기가 반환될 데이타의 크기보다 작음
07009 유효하지 않은 설명자 인덱스 recNumber의 값이 잘못됨

관련 함수#

SQLGetDescRec
SQLSetDescField
SQLSetDescRec