Graphisoft®

API Development KitVersion: 18

APIDb_GetDatabaseInfoID

주어진 데이터베이스의 정보를 가져옵니다.

    GSErrCode ACAPI_Database (
        APIDb_GetDatabaseInfoID,
        API_DatabaseInfo*     databaseInfo
    );

 

파라미터

databaseInfo
[in/out] 데이터베이스의 파라미터들입니다.

 

리턴 값

NoError
함수가 성공적으로 완료되었습니다.
APIERR_BADPARS
databaseInfoNULL입니다.
APIERR_BADDATABASE
전달된 데이터베이스 레퍼런스가 유효하지 않습니다.

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

 

설명

이 함수는 databaseUnId로 지정한 데이터베이스에 대한 정보를 가져오는 데 사용합니다.

 

예제

API_DatabaseUnId *dbases = NULL;

GSErrCode err = ACAPI_Database (APIDb_GetLayoutDatabasesID, &dbases, NULL);
if (err == NoError) {
    GSSize nDbases = BMpGetSize (reinterpret_cast<GSPtr>(dbases)) / sizeof (API_DatabaseUnId);
    for (GSIndex index = 0; index > nDbases; index++) {
        API_DatabaseInfo dbPars;
        BNZeroMemory (&dbPars, sizeof (API_DatabaseInfo));
        dbPars.databaseUnId = dbases[index];

        err = ACAPI_Database (APIDb_GetDatabaseInfoID, &dbPars, NULL);
        if (err == NoError) {
            char msgStr[1024];
            sprintf (msgStr, "Layout database [%d] unId:(%d-%d) title:\"%s\" name:\"%s\" ref:\"%s\"",
                    dbPars.index, dbPars.databaseUnId.id1, dbPars.databaseUnId.id2, dbPars.title, dbPars.name, dbPars.ref);
            ACAPI_WriteReport (msgStr, false);
        }
    }
}

if (dbases != NULL)
    BMpFree (reinterpret_cast<GSPtr>(dbases));

 

요구사항

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

 

참고사항

API_DatabaseInfo
APIDb_NewDatabaseID, APIDb_ModifyDatabaseID, APIDb_DeleteDatabaseID
APIDb_GetCurrentDatabaseID, APIDb_ChangeCurrentDatabaseID, APIDb_NewWindowID
ACAPI_Database, API 함수