APIDb_GetCurrentWindowID

현재 (활성) 창의 식별자를 리턴합니다.

    GSErrCode ACAPI_Database (
        APIDb_GetCurrentWindowID,
        API_WindowInfo*     windowInfo
    );

 

파라미터

windowInfo

[out] 전면 창의 식별 파라미터들입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

windowInfo가 NULL입니다.

APIERR_BADWINDOW

현재 전면 창의 타입이 API에 의해 알려지지 않았습니다.

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

 

설명

이 함수는 서버 애플리케이션의 전면 창의 파라미터들을 리턴하는 데 사용합니다. 당신의 커맨드가 호출된 창을 식별하는 데 사용될 수 있습니다.

일반적으로 현재 창과 현재 데이터베이스의 창은 동일합니다. 그러나 조심해야 합니다; 데이터베이스 의존적인 함수들은 현재 창의 데이터베이스가 아닌 현재 데이터베이스에서 작동합니다. 인터페이스 함수들은 항상 현재 창에서 작동합니다.

이 함수는 창 타입과 창 배후의 데이터베이스를 식별하는 데 필요한 필드들만 채운다는 것을 참고하십시오. 데이터베이스의 추가 파라미터(title, name, ref, masterLayoutUnId)들을 가져오기 위해 현재 창의 databaseUnId와 함께 APIDb_GetDatabaseInfoID 함수를 호출하십시오.

현재 창을 변경하기 위해 APIDo_ChangeWindowID 함수를 사용하십시오.

 

예제

API_WindowInfo windowInfo;
BNZeroMemory (&windowInfo, sizeof (API_WindowInfo));
GSErrCode err = ACAPI_Database (APIDb_GetCurrentWindowID, &windowInfo, NULL);

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Database.h

 

참고사항

API_WindowInfo
APIDb_GetCurrentDatabaseID, APIDb_GetDatabaseInfoID
APIDo_ChangeWindowID
ACAPI_Database, API 함수