Graphisoft®

API Development KitVersion: 18

APIEnv_ProjectID

현재 프로젝트 파일에 대한 정보를 리턴합니다.

    GSErrCode ACAPI_Environment (
        APIEnv_ProjectID,
        API_ProjectInfo*     projectInfo
    );

 

파라미터

projectInfo
[out] 프로젝트 파일 및 팀워크 프로젝트 지정 데이터입니다.

 

리턴 값

NoError
오류가 발생하지 않았습니다.
APIERR_BADPARS
projectInfoNULL입니다.
APIERR_NOPLAN
열린 프로젝트가 아닙니다.
APIERR_MEMFULL
메모리가 부족합니다.

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

 

설명

이 함수는 프로젝트 파일에 대한 정보를 가져오는 데 사용합니다. 팀워크 모드에서는 팀워크 관련 데이터 역시 이용 가능합니다. 리턴된 파라미터들의 정의는 API_ProjectInfo에서 보십시오.

프로젝트 파일을 예전에 저장했을 때에만 파일 사양을 이용할 수 있습니다. 'untitled' 프로젝트의 경우 데이터를 리턴하지 않습니다.

함수에 의해 생성된 IO::Location 객체들을 해제하는 것을 잊지 마십시오.

 

예제

API_ProjectInfo projectInfo;
ACAPI_Environment (APIEnv_ProjectID, &projectInfo, NULL);
if (projectInfo.location != NULL)
    delete projectInfo.location;
if (projectInfo.location_team != NULL)
    delete projectInfo.location_team;

 

요구사항

버전: API 2.1 또는 이후
헤더: APIdefs_Environment.h

 

참고사항

API_ProjectInfo
APIEnv_UserWorkspaceID
ACAPI_Environment, API 함수