ACAPI_Element_GetElemListByIFCIdentifier

특정 IFC 식별자들을 갖고 있는 요소들을 가져옵니다.

    GSErrCode  ACAPI_Element_GetElemListByIFCIdentifier (
        API_Guid*                       archicadIFCID,
        API_Guid*                       externalIFCID,
        GS::Array<API_Guid>*            elements
    );

 

파라미터

archicadIFCID 

[in] ArchiCAD IFC ID - NULL이 될 수 있음

externalIFCID 

[in] 외부 IFC ID - NULL이 될 수 있음

elements 

[out] 요소들의 GUID입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

archicadIFCID와 externalIFCID 모두 NULL이거나 elements 파라미터가 NULL입니다.

APIERR_MODULNOTINSTALLED

IFC 애드온이 존재하지 않습니다.

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

 

설명

이 함수는 표시된 IFC guid를 갖고 있는 요소들을 검색합니다.

• archicadIFCID만 값을 포함한 경우 - 표시된 ArchiCAD IFC ID를 갖고 있는 요소를 검색합니다. elements는 최대 1개의 요소를 가질 수 있습니다.
• externalIFCID만 값을 포함한 경우 - 표시된 외부 IFC ID를 갖고 있는 요소를 검색합니다. elements는 1개보다 더 많은 요소를 가질 수 있습니다.
• archicadIFCID와 externalIFCID 둘 다 값을 포함한 경우 - 표시된 ArchiCAD IFC ID와 외부 IFC ID를 갖고 있는 요소를 검색합니다. elements는 최대 1개의 요소를 가질 수 있습니다.
• 두 입력 파라미터들이 NULL인 경우 - APIERR_BADPARS를 리턴합니다.

IFC Guid 문자열(IfcGloballyUniqueId)에서 API_Guid로 변환하는 것은 APIAny_IFCGuidToAPIGuidID로 할 수 있습니다.

 

요구사항

버전: API 18 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_Element_GetIFCIdentifier
APIAny_APIGuidToIFCGuidID
APIAny_IFCGuidToAPIGuidID