Graphisoft®

API Development KitVersion: 18

APIDb_GetDrawingLinkID

드로잉 링크에 대한 다양한 정보를 리턴합니다.

    GSErrCode ACAPI_Database (
        APIDb_GetDrawingLinkID,
        const API_Guid*          guid,
        API_DrawingLinkInfo*     drawingLinkInfo
    );

 

파라미터

guid
[in] 드로잉의 guid로 식별되는 드로잉 링크에 대한 정보를 가져옵니다.
drawingLinkInfo
[out] 드로잉 링크의 타입, guid 등입니다.

 

리턴 값

NoError
함수가 성공적으로 완료되었습니다.
APIERR_BADPARS
드로잉 링크가 유효하지 않습니다.

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

 

설명

이 함수는 linkUID 파라미터로 식별되는 드로잉 링크에 대한 기본 정보를 가져오는 데 사용합니다.

아래 예제에 나와 있는 것처럼 함수에 의해 동적으로 할당된 linkPath 위치와 viewPath 포인터를 해제하는 것을 기억하십시오.

 

예제

Int32 IsExternalView (API_DrawingType* drawing)
{
    API_DrawingLinkInfo drawingLinkInfo;
    BNZeroMemory (&drawingLinkInfo, sizeof (API_DrawingLinkInfo));

    GSErrCode err = ACAPI_Database (APIDb_GetDrawingLinkID, (void *) (&drawing->head.guid), &drawingLinkInfo);
    if (drawingLinkInfo.linkPath != NULL)
        delete drawingLinkInfo.linkPath;
    if (drawingLinkInfo.viewPath != NULL)
        BMKillPtr (&drawingLinkInfo.viewPath);

    if (err != NoError)
        return -1;
    else if (drawingLinkInfo.linkTypeID == API_DrawingLink_ExternalViewID)
        return 1;

    return 0;
}

 

요구사항

버전: API 10 또는 이후
헤더: APIdefs_Database.h

 

참고사항

API_DrawingLinkInfo, API_DrawingType
ACAPI_Database, API 함수