APIDb_GetHotlinkInstancesID

주어진 핫링크 노드로부터 배치된 핫링크 인스턴스 요소들의 리스트를 리턴합니다.

    GSErrCode ACAPI_Database (
        APIDb_GetHotlinkInstancesID,
        const API_Guid*          hotlinkNodeGuid,
        GS::Array<API_Guid>*     elementRefList
    );

 

파라미터

hotlinkNodeGuid

[in] 핫링크 노드의 guid입니다.

elementRefList

[out] 핫링크 인스턴스들의 guid 리스트입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

파라미터들 중 하나 이상이 NULL입니다.

APIERR_BADID

지정한 guid에 의해 발견된 핫링크 요소가 없습니다.

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

 

설명

이 함수는 지정한 핫링크 노드의 API_HotlinkType 핫링크 인스턴스 요소들을 가져옵니다.

 

예제

Int32 allInstancesCounter = 0;
Int32 nestedCounter = 0;
Int32 hotlinkmoduleCounter = 0;
Int32 xrefCounter = 0;

GS::Array<API_Guid> nodeRefList;
if (ACAPI_Database (APIDb_GetHotlinkNodesID, NULL, &nodeRefList) == NoError) {
    for (UIndex iNode = 0; iNode < nodeRefList.GetSize (); iNode++) {
        GS::Array<API_Guid> elementRefList;
        if (ACAPI_Database (APIDb_GetHotlinkInstancesID, &nodeRefList[iNode], &elementRefList) == NoError) {
            for (UIndex iElem = 0; iElem < elementRefList.GetSize (); iElem++) {
                API_Element element;
                BNZeroMemory (&element, sizeof (API_Element));
                element.header.guid = elementRefList[iElem];
                if (ACAPI_Element_Get (&element) == NoError && element.header.typeID == API_HotlinkID) {
                    allInstancesCounter++;
                    if (element.header.hotlinkGuid != APINULLGuid)
                        nestedCounter++;
                    if (element.hotlink.type == APIHotlink_Module)
                        hotlinkmoduleCounter++;
                    if (element.hotlink.type == APIHotlink_XRef)
                        xrefCounter++;
                }
            }
        }
    }
}

 

요구사항

버전: API 12 또는 이후

헤더: APIdefs_Database.h

 

참고사항

API_HotlinkType
APIDb_GetHotlinkNodeID
APIDb_GetHotlinkNodesID
APIDb_GetHotlinkRootNodeGuidID
APIDb_GetHotlinkNodeTreeID
APIDb_GetCompoundInfoStringID
ACAPI_Database
API 함수