SQLGetStmtAttr

SQLGetStmtAttr

현재 설정되어 있는 명령문 핸들과 관련된 속성 값을 가져온다.

Unicode SQLGetStmtAttrW() 동작은 SQLGetStmtAttr()와 동일하다.

구 문

SQLRETURN  SQLGetStmtAttr (
    SQLHSTMT        stmt,
    SQLINTEGER      Attribute,
    SQLPOINTER      param,
    SQLINTEGER      StringLength
    SQLINTEGER *    StringLengthPtr );

인 자

자료유형	인자	사용	설명
SQLHSTMT	stmt	입력	명령문 핸들
SQLINTEGER	Attribute	입력	설정할 속성. SQLSetStmtAttr() 참조할 것.
SQLPOINTER	param	출력	Attribute와 연관된 값의 포인터 Attribute 값에 따라 param은 32 bit 부호 없는 정수 값이거나 null-terminated 문자열의 포인터, 바이너리 버퍼, 또는 ODBC에서 정의된 값 Attribute가 ODBC 고유의 값이면 param은 부호 표시 정수임
SQLINTEGER	StringLength	입력	Attribute가 ODBC에서 정의된 속성이고 param이 문자열 또는 바이너리 버퍼를 가리키면 이 인자는 *param의 바이트 길이여야만 한다. Attribute가 ODBC에서 정의된 속성이고 param이 정수면 이 인자는 무시된다.
SQLINTEGER *	StringLengthPtr	출력	*ValuePtr에 반환되는 값의 바이트 길이를 반환(null-termination character 제외)

결괏값

SQL_SUCCESS
SQL_SUCCESS_WITH_INFO
SQL_ERROR
SQL_INVALID_HANDLE

설 명

SQLGetStmtAttr()는 명령문 핸들과 관련된 속성을 반환한다. 명령문 속성이나 자세한 내용은SQLSetStmtAttr()를 참조하기 바란다.

진 단

SQLSTATE	설명	부연설명
HY090	유효하지 않은 문자열 또는 버퍼 길이	StringLength가 0보다 작다.
HY092	유효하지 않은 속성 또는 옵션	Attribute 인자에 명시된 값이 이 드라이버에서 지원하는 유효한 값이 아니다.
HYC00	구현되지 않은 옵션	Attribute 인자에 명시된 값이 이 드라이버에서 지원하는 ODBC에서 유효한 값이나 현재 지원되지 않는다.

관련 함수

SQLGetConnectAttr
SQLSetConnectAttr
SQLSetStmtAttr