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