APIIo_InitProcessWindowID

프로세스 창을 엽니다.

    GSErrCode ACAPI_Interface (
        APIIo_InitProcessWindowID,
        const char*     title,
        short*          nPhase
    );

 

파라미터

title

[in] 프로세스 문자열입니다.

nPhase

[in] 단계들의 수입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

파라미터들 중 하나 이상이 NULL입니다.

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

 

설명

이 함수는 긴 동작을 진행하는 동안 프로세스 창을 준비하는 데 사용합니다. 당신은 전체 동작의 이름과 프로세스의 단계들의 수를 지정할 수 있습니다. 전달된 프로세스 타이틀은 31 글자에 맞게 잘리게 될 것입니다.

그 외 프로세스 창 관련 함수들은 다음과 같습니다:

• APIIo_SetNextProcessPhaseID
• APIIo_SetProcessValueID
• APIIo_IncProcessValueID
• APIIo_IsProcessCanceledID
• APIIo_CloseProcessWindowID

 

예제

GSErrCode           err;
API_LibPart         libPart;
short               nPhase;
Int32               i, nLib;
char                buffer [256];

err = ACAPI_LibPart_GetNum (&nLib);
if (nLib > 0) {
    nPhase = 1;

    ACAPI_Interface (APIIo_InitProcessWindowID, "Listing the library", &nPhase);
    ACAPI_Interface (APIIo_SetNextProcessPhaseID, "working...", &nLib);

    BNZeroMemory (&libPart, sizeof (API_LibPart));
    for (i = 1; i <= nLib; i++) {
        libPart.index = i;
        err = ACAPI_LibPart_Get (&libPart);
        if (!err) {
            sprintf (buffer, "[%2d] \"%s\"", i, (const char *) GS::UniString (libPart.docu_UName).ToCStr ());
            ACAPI_WriteReport (buffer, false);
        }

        ACAPI_Interface (APIIo_SetProcessValueID, &i, NULL);
        if (ACAPI_Interface (APIIo_IsProcessCanceledID, NULL, NULL))
            break;
    }

    ACAPI_Interface (APIIo_CloseProcessWindowID, NULL, NULL);
}

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Interface.h

 

참고사항

APIIo_SetNextProcessPhaseID, APIIo_SetProcessValueID, APIIo_IncProcessValueID, APIIo_IsProcessCanceledID, APIIo_CloseProcessWindowID,
ACAPI_Interface, API 함수