APIDb_ModifyDatabaseID

독립적인 디테일, 워크시트, 레이아웃, 또는 마스터 레이아웃 데이터베이스의 파라미터들을 변경합니다.

    GSErrCode ACAPI_Database (
        APIDb_ModifyDatabaseID,
        API_DatabaseInfo*     databaseInfo
    );

파라미터

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

리턴 값

NoError: 함수가 성공적으로 완료되었습니다.
APIERR_NOPLAN: 열린 평면도 창이 없습니다.
APIERR_BADPARS: databaseInfo가 NULL입니다.
APIERR_REFUSEDPAR: 전달된 typeID가 APIWind_DetailID, APIWind_WorksheetID, APIWind_LayoutID 또는 APIWind_MasterLayoutID가 아닙니다.
APIERR_REFUSEDCMD: 팀워크 파일에서 서명을 하는 동안 데이터베이스 파라미터들을 변경하려고 시도했습니다.
APIERR_NOTMINE: 팀워크 모드에서 데이터베이스 파라미터들을 변경하기에는 권한들이 불충분합니다.
APIERR_GENERAL: 데이터베이스 파라미터들을 변경하는 것에 실패하였습니다.

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

설명

이 함수를 이용하여 독립적인 디테일, 워크시트, 레이아웃 또는 마스터 레이아웃 데이터베이스의 이름을 변경할 수 있고, 그것들의 레퍼런스 ID를 변경할 수 있습니다.
데이터베이스의 title 파라미터는 변경할 수 없음을 참고하십시오.

유효한 masterLayoutUnId를 전달하여 레이아웃 데이터베이스의 마스터를 변경할 수도 있습니다.

예제

API_DatabaseInfo dbInfo;
BNZeroMemory (&dbInfo, sizeof (API_DatabaseInfo));

GSErrCode err = ACAPI_Database (APIDb_GetCurrentDatabaseID, &dbInfo, NULL);
if (err == NoError && dbInfo.typeID == APIWind_LayoutID) {
    CHCopyC ("Renamed Layout", dbInfo.name);
    ACAPI_Database (APIDb_ModifyDatabaseID, &dbInfo, NULL);
}

요구사항

버전: API 10 또는 이후

헤더: APIdefs_Database.h

참고사항

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