SQLAllocEnv

SQLAllocEnv

환경 핸들과 관련된 자원들을 할당한다.

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

구 문

SQLRETURN  SQLAllocEnv ( 
    SQLHENV *   env );

인 자

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

결괏값

SQL_SUCCESS
SQL_ERROR

설 명

한 애플리케이션에서 여러 개의 환경을 사용할 수 있다.

모든 Altibase CLI 자원이 계속 사용 중이려면 SQLAllocEnv()를 호출한 프로그램이 종료되거나 스택을 벗어나서는 안된다. 그렇지 않으면, 애플리케이션은 명령문 핸들과 할당한 다른 자원들을 잃을 수 있다.

애플리케이션은 SQLAllocConnect() 또는 다른 Altibase CLI 함수를 호출 하기전에 이 함수를 먼저 호출해야 한다. 이 후에 입력값으로 환경 핸들을 필요로하는 모든 함수에 env 값이 전달된다.

관련 함수

SQLAllocConnect
SQLAllocStmt
SQLFreeEnv

예 제

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

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