APIDb_InitCreationOrderTableID

생성 순서 상의 다음 요소에 빠르게 접근하기 위해 내부 테이블을 초기화합니다.

    GSErrCode ACAPI_Database (
        APIDb_InitCreationOrderTableID,
        API_ElemFilter*     elemFilter
    );

 

파라미터

elemFilter

[in] 선택적인 파라미터입니다. NULL일 수 있습니다. 접근 테이블로부터 요소 타입들을 제외하려면 이 필터를 사용하십시오.

 

리턴 값

NoError

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

APIERR_MEMFULL

내부 생성 순서 테이블을 할당할 수 없습니다.

APIERR_NESTING

내부 접근 테이블 초기화들은 중첩(nested)될 수 없습니다. 즉, 당신은 새로운 테이블을 초기화하기 전에 예전에 할당한 테이블을 폐기해야 합니다.

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

 

설명

이 함수는 생성 순서 상의 다음 요소에 빠르게 접근할 수 있게 해주는 내부 테이블을 설정하는 데 사용합니다. (예전 버전들에서의 유일 ID ordering과 다소 비슷함)

 

예제

static void  PrintGuidsInCreationOrder (void)
{
    if (ACAPI_Database (APIDb_InitCreationOrderTableID, NULL, NULL) == NoError) {
        API_Guid guid = APINULLGuid;
        while ((ACAPI_Database (APIDb_CreationOrderGetNextID, &guid, NULL) == NoError) &&
               (guid != GS::NULLGuid))
        {
            ACAPI_WriteReport (APIGuid2GSGuid (guid).ToUniString ().ToCStr (), false);
        }
        ACAPI_Database (APIDb_DisposeCreationOrderTableID, NULL, NULL);
    }

    return;
}

 

요구사항

버전: API 11.01 또는 이후

헤더: APIdefs_Database.h

 

참고사항

ACAPI_Database, APIDb_CreationOrderGetNextID, APIDb_DisposeCreationOrderTableID, API 함수