APIDb_GetCurrentDatabaseID

현재 (활성) 데이터베이스의 식별자를 리턴합니다.

    GSErrCode ACAPI_Database (
        APIDb_GetCurrentDatabaseID,
        API_DatabaseInfo*     databaseInfo
    );

 

파라미터

databaseInfo

[out] 현재 데이터베이스의 식별 파라미터들입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADPARS

databaseInfo가 NULL입니다.

APIERR_BADWINDOW

현재 데이터베이스의 타입은 API에 의해 알려지지 않았습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 서버 애플리케이션의 현재 데이터베이스의 파라미터들을 리턴하는 데 사용합니다. 이것은 후속 API 호출들이 작업하게 될 데이터베이스를 식별하는 데 사용될 수 있습니다.

일반적으로 현재 창과 현재 데이터베이스의 창은 동일합니다. 그러나 반드시 조심해야 합니다; 데이터베이스 의존적인 함수들은 현재 창의 데이터베이스가 아닌 현재 데이터베이스 상에서 작동합니다. APIDb_ChangeCurrentDatabase 함수를 호출하여 현재 데이터베이스를 변경할 수 있습니다.

 

예제

API_DatabaseInfo    databaseInfo;
GSErrCode           err;

BNZeroMemory (&databaseInfo, sizeof (API_DatabaseInfo));
err = ACAPI_Database (APIDb_GetCurrentDatabaseID, &databaseInfo, NULL);

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Database.h

 

참고사항

API_DatabaseInfo
APIDb_ChangeCurrentDatabase
ACAPI_Database
API 함수