ACAPI_ElementSet_Delete

기존 요소 집합을 제거합니다.

    GSErrCode  ACAPI_ElementSet_Delete (
        API_Guid     setGuid
    );

 

파라미터

setGuid 

[in] 제거할 요소 집합의 GUID입니다.

 

리턴 값

NoError

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

APIERR_BADDATABASE

함수가 현재 데이터베이스에서 작동할 수 없습니다.

APIERR_REFUSEDCMD

함수가 undoable이어야 합니다. 열린 undoable session이 없습니다.

APIERR_BADID

setGuid 파라미터가 유효하지 않습니다.

APIERR_NOTMINE

요소 집합이 다른 사용자가 소유한 setGuid에 의해 참조됩니다.

APIERR_DELETED

요소 집합이 이미 제거되었습니다.

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

 

설명

이 함수는 setGuid 파라미터에 의해 식별되는 요소 집합을 제거합니다.

당신은 또 다른 애드온들에 의해 생성된 요소 집합들을 제거할 수 없음을 참고하십시오.

 

예제

// 요소를 참조하는 모든 요소 집합들을 제거함 (guid로 식별함)
void DeleteElementSets (const API_Guid& guid)
{
    GS::Array<API_Guid> setGuids;
    GSErrCode err = ACAPI_ElementSet_Identify (guid, &setGuids);
    if (err == NoError) {
        USize nSet = setGuids.GetSize ();
        ACAPI_OpenUndoableSession ("Delete Element Set");

        for (UIndex i = 0; i < nSet; i++) {
            err = ACAPI_ElementSet_Delete (setGuids[i]);
            if (err != NoError) {
                DBPRINTF ("Delete Element Set error: %d\n", err);
            }
        }

        ACAPI_CloseUndoableSession ();
    }
}

 

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_ElementSet_Create
ACAPI_ElementSet_GetData
ACAPI_ElementSet_Identify
요소 집합 관리자
API 함수