SQLAllocConnect

SQLAllocConnect

입력 환경 핸들에 의해 식별된 환경 내에서 연관된 자원과 연결 핸들을 할당한다. 연결 핸들과 입력 환경 핸들에 의해 식별된 환경에서 관련 자원을 할당한다.

SQLAllocConnect()는 SQLAllocHandle()로 대체될 수 있다.

구 문

SQLRETURN  SQLAllocConnect (
    SQLHENV     env,
    SQLHDBC *   dbc );

인 자

자료유형	인자	사용	설명
SQLHENV	env	입력	환경 핸들
SQLHDBC *	dbc	출력	연결 핸들의 포인터

결괏값

SQL_SUCCESS
SQL_INVALID_HANDLE
SQL_ERROR

설명

출력 연결 핸들은 일반적인 상태 정보, 트랜잭션 상태, 오류 정보를 포함한 연결과 관련되는 모든 정보를 참조하기 위해 Altibase CLI 드라이버에 의해 사용된다.

연결 핸들을 가리키는 포인터 (dbc)가 SQLAllocConnect()에 의해 할당된 유효한 연결 핸들을 가리키면, 이 호출의 결과에 의해 원래의 값이 바뀐다. 이것은 애플리케이션 프로그래밍 오류로, Altibase CLI 드라이버에 의해 감지되지 않는다.

이 함수를 호출하기 전에 SQLAllocEnv()를 호출해야 한다.

진 단

SQLSTATE	설명	부연설명
HY000	일반 오류	채널 초기화 오류
HY001	메모리 할당 오류	명시된 핸들을 위한 메모리 할당에 실패 함.
HY009	유효하지 않은 인자 (null pointer) 사용	dbc가 null pointer 임.

관련 함수

SQLAllocEnv
SQLConnect
SQLDisconnect
SQLFreeConnect

예 제

< $ALTIBASE_HOME/sample/SQLCLI/demo_ex1.cpp 참고 >

/* Environment 을 위한 메모리를 할당 */
if (SQLAllocEnv (&env) != SQL_SUCCESS)
{
    printf("SQLAllocEnv error!!\n");
    return SQL_ERROR;
}

/* Connection 을 위한 메모리를 할당  */
if (SQLAllocConnect (env, &dbc) != SQL_SUCCESS)
{
    printf("SQLAllocConnect error!!\n");
    return SQL_ERROR;
}