APIEnv_ProjectID
현재 프로젝트 파일에 대한 정보를 리턴합니다.
GSErrCode ACAPI_Environment ( APIEnv_ProjectID, API_ProjectInfo* projectInfo );
파라미터
- projectInfo
- [out] 프로젝트 파일 및 팀워크 프로젝트 지정 데이터입니다.
리턴 값
NoError
- 오류가 발생하지 않았습니다.
APIERR_BADPARS
projectInfo
가NULL
입니다.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 함수