ACAPI_Element_Link

하나의 요소를 다른 요소로 연결합니다.

    GSErrCode  ACAPI_Element_Link (
        API_Guid     guid_linkFrom,
        API_Guid     guid_linkTo,
        GSFlags      linkFlags
    );

파라미터

guid_linkFrom: [in] 다른 요소가 링크될 요소를 식별합니다.
guid_linkTo: [in] 1번째 요소에 링크할 요소를 식별합니다.
linkFlags: [in] 링크와 함께 저장할 커스텀 flag들입니다.

리턴 값

NoError: 함수가 성공적으로 완료되었습니다.
APIERR_REFUSEDCMD: 함수는 undoable이어야 합니다. 열린 undoable session이 없습니다.
APIERR_BADDATABASE, APIERR_NOTMINE: 함수가 현재 데이터베이스에서 작동할 수 없습니다.
APIERR_BADID: 전달된 유일 ID들 중 하나나 둘 다 유효하지 않습니다. 또는 두 ID가 동일합니다.
APIERR_LINKEXIST: 이미 요소들이 서로 링크되어 있습니다.

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

설명

링크를 생성하는 애드온 역시 링크와 함께 등록됩니다; 그래서 링크는 애드온에 "소속됩니다".

요소 링크를 사용하는 것의 장점은 서버 애플리케이션이 자동으로 GUID들의 변경사항을 자동으로 추적하고 그에 따라 업데이트한다는 것입니다.

링크를 구축한 후에 콜백 함수로 요소 옵저버를 설치할 수도 있으며, 이는 관측된 요소 중 하나가 변경될 때 호출될 것입니다. 이 콜백에서 당신은 ACAPI_Element_GetLinks로 관측된 요소에 링크된 다른 요소들을 찾을 수 있으며 ACAPI_Element_GetLinkFlags로 제공된 linkFlags를 가져올 수 있습니다. 다 마친 후에는 ACAPI_Element_Unlink로 링크를 제거할 수 있습니다.

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

참고사항

ACAPI_Element_Unlink, ACAPI_Element_GetLinks, ACAPI_Element_GetLinkFlags,
API 함수