ACAPI_Element_GetIFCIdentifier

요소의 IFC 식별자를 가져옵니다

    GSErrCode  ACAPI_Element_GetIFCIdentifier (
        const API_Guid&                 elementID,
        API_Guid&                       archicadIFCID,
        API_Guid&                       externalIFCID
    );

 

파라미터

elementID

[in] 요소의 GUID입니다.

archicadIFCID

[out] 요소의 ArchiCAD IFC ID입니다.

externalIFCID

[out] 요소의 외부 IFC ID입니다.

 

리턴 값

NoError

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

APIERR_BADID

유효하지 않은 값이 elementID 파라미터에 전달되었습니다.

APIERR_MODULNOTINSTALLED

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

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

 

설명

이 함수는 요소의 IFC 식별자를 리턴합니다. 2가지 종류의 식별자들이 존재합니다:

• ArchiCAD IFC ID - IFC 내보내기를 하는 동안 이 값은 GlobalId 속성에 작성될 것입니다. 그리고 IFC 관리자에 보일 수 있습니다.
• External IFC ID - 만약 요소가 본래 IFC에서 온 것이라면 GlobalId를 포함하고 있습니다. 만약 그렇지 않으면 APINULLGuid를 포함하게 될 것입니다. 또한 IFC 관리자에 보일 수 있습니다.

API_Guid에서 IFC Guid 문자열(IfcGloballyUniqueId)로의 변환은 APIAny_APIGuidToIFCGuidID로 할 수 있습니다.

 

요구사항

버전: API 18 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_Element_GetElemListByIFCIdentifier
APIAny_APIGuidToIFCGuidID
APIAny_IFCGuidToAPIGuidID