ACAPI_LibPart_GetSectionList

등록된 라이브러리 파트가 저장하고 있던 섹션들의 리스트를 리턴합니다.

    GSErrCode  ACAPI_LibPart_GetSectionList (
        Int32                     libInd,
        Int32*                    nSection,
        API_LibPartSection***     sections
    );

 

파라미터

libInd

[in] 라이브러리 파트의 인덱스입니다.

nSection

[out] 발견된 섹션들의 수입니다.

sections

[out] 리턴된 섹션 데이터입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

유효하지 않은 libInd입니다. 또는
파라미터 중 NULL인 것이 있습니다. 또는
호출된 라이브러리 파트는 매크로, 그림 파일 등입니다.

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

 

설명

이 함수는 라이브러리 파트를 만드는 섹션들의 헤더들을 가져오는 데 사용합니다.

함수는 실제 라이브러리 파트에서만 작동합니다. 대상 라이브러리 파트의 타입이 아래 목록에 있지 않은 것이라면, 함수는 오류 코드를 리턴합니다. 다른 타입의 라이브러리 파트들은 단지 활성 라이브러리 폴더로부터 열거되고 등록된 단순한 그림 또는 텍스트 파일들이기 때문입니다; 그림 또는 매크로.

라이브러리 파트의 적용 가능한 타입은 다음과 같습니다:

• APILib_WindowID,
• APILib_DoorID,
• APILib_ObjectID,
• APILib_LampID,
• APILib_RoomID,
• APILib_LabelID,
• APILib_MacroObjID,
• APILib_PropertyID

만약 더 이상 필요하지 않으면 데이터를 폐기하는 것을 잊지 마십시오.

이것은 ACAPI_LibPart_Create와 ACAPI_LibPart_Save 함수 사이에서 사용할 수 없다는 것을 참고하십시오.

 

예제

Int32                nSection = 0;
API_LibPartSection   **sectList;
GSHandle             sectionHdl;
char                 buffer[128];

GSErrCode err = ACAPI_LibPart_GetSectionList (1, &nSection, &sectList);
if (err == NoError) {
    for (Int32 i = 0; i < nSection; i++) {
        API_LibPartSection* sectionPtr = *sectList + i;
        err = ACAPI_LibPart_GetSection (1, sectionPtr, &sectionHdl, NULL);
        BMKillHandle (&sectionHdl);
        sprintf (buffer, "sectType: %d, subIndent: %d, version: %d", sectionPtr->sectType, sectionPtr->subIdent, sectionPtr->version);
        ACAPI_WriteReport (buffer, false);
    }
    BMKillHandle ((GSHandle *) &sectList);
}

 

요구사항

버전: API 2.1 또는 이후

헤더: ACAPinc.h

 

참고사항

API_LibPartSection,
ACAPI_LibPart_GetSection, ACAPI_LibPart_Create, ACAPI_LibPart_Save,
라이브러리 파트 관리자, API 함수