APIEnv_GetLibrariesID

로드된 라이브러리들의 리스트를 리턴합니다.

    GSErrCode ACAPI_Environment (
        APIEnv_GetLibrariesID,
        GS::Array<API_LibraryInfo>*     activeLibs,
        Int32*                          embeddedLibraryIndex
    );

 

파라미터

activeLibs

활성 라이브러리 리스트입니다.

embeddedLibraryIndex 

[out] 선택적입니다; 이 리스트 안의 Embedded 라이브러리의 0-기반 인덱스입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

activeLibs가 NULL입니다.

APIERR_MEMFULL

메모리가 부족합니다.

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

 

설명

이 함수는 ArchiCAD의 활성 라이브러리들의 리스트를 가져오는 데 사용합니다. 더 자세한 것은 API_LibraryInfo를 참고하십시오.

활성 라이브러리들을 변경하려면 APIEnv_SetLibrariesID 함수를 사용하십시오.

 

예제

GS::Array<API_LibraryInfo>    activeLibs;
UInt32               i;
char                 buffer[1024];
GS::UniString        path;
GSErrCode            err;

err = ACAPI_Environment (APIEnv_GetLibrariesID, &activeLibs);
if (err != NoError) {
    GiveMessage_Err ("Error in APIEnv_GetLibrariesID", err);
    return;
}

GiveMessage ("Active library folders", false);

for (i = 0; i < activeLibs.GetSize (); i++) {
    activeLibs[i].location.ToPath (&path);
    sprintf (buffer, "[%u]  %s", i+1, path.ToCStr (0, MaxUSize, CC_UTF8).Get ());
    GiveMessage (buffer, false);
}

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Environment.h

 

참고사항

API_LibraryInfo,
APIEnv_SetLibrariesID,
ACAPI_Environment, API 함수