SQLGetDescRec

SQLGetDescRec

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

Unicode SQLGetDescRecW() 동작은 SQLGetDescRec()와 동일하다.

구 문

SQLRETURN SQLGetDescRec (
        SQLHDESC    desc,
        SQLSMALLINT recNumber,
        SQLCHAR     *name,
        SQLSMALLINT bufferLength,
        SQLSMALLINT *stringLength,
        SQLSMALLINT *type,
        SQLSMALLINT *subType,
        SQLLEN      *lengthPtr,
        SQLSMALLINT *precision,
        SQLSMALLINT *scale,
        SQLSMALLINT *nullable);

인 자

자료유형	인자	사용	설명
SQLHDESC	desc	입력	descriptor 핸들
SQLSMALLINT	recNumber	입력	칼럼번호 1부터 시작
SQLCHAR *	name	출력	칼럼의 이름을 받아올 포인터
SQLSMALLINT	bufferLength	입력	name 버퍼의 크기
SQLSMALLINT *	stringLength	출력	name 에 저장된 크기
SQLSMALLINT *	type	출력	칼럼의 타입을 받아올 포인터
SQLSMALLINT *	subType	출력	칼럼의 subtype을 받아올 포인터
SQLLEN *	lengthPtr	출력	칼럼의 길이를 받아올 포인터
SQLSMALLINT *	precision	출력	칼럼의 정밀도를 받아올 포인터
SQLSMALLINT *	scale	출력	칼럼의 스케일을 받아올 포인터
SQLSMALLINT *	nullable	출력	칼럼의 null 여부를 받아올 포인터

결괏값

SQL_SUCCESS
SQL_SUCCESS_WITH_INFO
SQL_NO_DATA
SQL_INVALID_HANDLE
SQL_ERROR

설 명

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

진 단

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

관련 함수

SQLBindCol
SQLBindParameter
SQLGetDescFiled