ACAPI_Element_GetLinks

주어진 요소에 링크된 요소들의 리스트를 리턴합니다.

    GSErrCode  ACAPI_Element_GetLinks (
        API_Guid        guid_linkFrom,
        API_Guid***     guid_linkTo,
        Int32*          nLinks
    );

 

파라미터

guid_linkFrom 

[in] 다른 요소들이 링크된 요소를 식별합니다.

guid_linkTo 

[out] 1번째 요소에 링크된 요소들의 GUID들을 리턴합니다. (NULL이 될 수 있음)

nLinks

[out] 1번째 요소에 링크된 요소들의 개수를 리턴합니다.

 

리턴 값

NoError

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

APIERR_BADPARS

전달된 nLinks 포인터가 NULL입니다.

APIERR_BADDATABASE, APIERR_NOTMINE

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

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

 

설명

요소 링크들은 양방향이 아닙니다. 당신은 항상 하나의 요소에서 다른 요소로 연결할 수 있습니다. 이 함수는 guid_linkFrom GUID를 갖고 있는 요소에 링크된 요소들의 리스트를 리턴합니다.

전달된 guid_linkTo 파라미터는 NULL이 될 수 있습니다; 이 경우 API는 주어진 요소에 링크된 요소들의 개수만 리턴합니다.

만약 이 함수가 닫히지 않은 undoable 세션에서 호출되었으면, 이것은 기존 링크들뿐만 아니라 현재 undoable 세션에서 제거된 링크들도 리턴한다는 것을 참고하십시오.

 

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_Element_Link, ACAPI_Element_Unlink, ACAPI_Element_GetLinkFlags,
API 함수