ACAPI_TeamworkControl_ReserveLockable

팀워크 모드에서 잠금가능한 객체 집합을 예약합니다.

    GSErrCode  ACAPI_TeamworkControl_ReserveLockable (
        const API_Guid&                    objectId,
        GS::PagedArray<GS::UniString>*     conflicts = NULL
    );

 

파라미터

objectId

[in] 잠금가능한 객체 집합의 유일 식별자입니다.

conflicts

[out] 충돌하는 사용자들의 리스트입니다. (현재 사용하지 않음)

 

리턴 값

NoError

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

APIERR_NOPLAN

열린 프로젝트가 없습니다.

APIERR_NOTEAMWORKPROJECT

현재 프로젝트는 팀워크 프로젝트가 아닙니다.

APIERR_BADID

주어진 objectId가 유효한 잠금가능한 객체 집합 식별자가 아닙니다.

APIERR_SERVICEFAILED

잠금을 획득할 수 없습니다. 또는 통신 또는 서버 오류로 인하여 동작이 실패했습니다.

다른 공통 오류들에 대해서는 오류 코드들의 리스트를 보십시오.

 

설명

이 함수는 팀워크 모드에서 잠금가능한 객체 집합을 예약하는 데 사용합니다.

잠금가능한 객체 집합를 예약하기 전에, 현재 사용자가 객체 집합을 편집할 충분한 권한들을 갖고 있음을 확인하십시오. (ACAPI_TeamworkControl_HasDeleteModifyRight) 또한 예약 전에 잠금 상태를 확인하는 것을 권장합니다. (ACAPI_TeamworkControl_GetLockableStatus)

더 이상 예약이 필요 없을 때 잠금가능한 객체 집합을 해제하는 것을 잊지 마십시오.

 

예제

API_Guid objectSetGuid = GSGuid2APIGuid (GS::Guid ("4779D92D-ACFB-429d-91E5-1D585B9D2CE5"));
API_LockableStatus lockableStatus = ACAPI_TeamworkControl_GetLockableStatus (objectSetGuid);

if (lockableStatus == APILockableStatus_Free) {
    GSErrCode errCode = ACAPI_TeamworkControl_ReserveLockable (objectSetGuid, NULL);
    if (errCode == NoError)
        ACAPI_WriteReport ("Profile attributes has been reserved succesfully", true);
    else
        ACAPI_WriteReport ("Reservation of Profile attributes has failed", true);
} else if (lockableStatus == APILockableStatus_Editable) {
    ACAPI_WriteReport ("Profile attributes has already been reserved", true);
} else {
    ACAPI_WriteReport ("Profile attributes cannot be reserved at the moment", true);
}

 

요구사항

버전: API 13 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_TeamworkControl_HasDeleteModifyRight
ACAPI_TeamworkControl_GetLockableStatus
ACAPI_TeamworkControl_ReleaseLockable
ACAPI_Notify_CatchLockableReservationChange
팀워크 제어
API 함수`