LPEVALCOMCALLBACK 콜백 함수(evalcom2.h)

아티클
08/23/2023

LPEVALCOMCALLBACK 사양은 콜백 함수 프로토타입을 정의합니다. IValidate::SetStatus 메서드를 사용하면 작성 도구가 등록된 콜백 함수를 통해 유효성 검사 진행률에 대한 정보를 받을 수 있습니다.

구문

LPEVALCOMCALLBACK Lpevalcomcallback;

BOOL Lpevalcomcallback(
  [in] STATUSTYPES iStatus,
       LPCWSTR szData,
       LPVOID pContext
)
{...}

매개 변수

[in] iStatus

evalcom2에서 보낸 상태 메시지를 지정합니다.

값	의미
NULL	이 매개 변수의 값
ieStatusICECount 1	실행 중인 ICE 수입니다.
ieStatusMerge 2	패키지 또는 병합 모듈을 .cub 파일과 병합합니다.
ieStatusSummaryInfo 3	요약 정보 스트림 병합
ieStatusCreateEngine 4	ICE 실행 준비
ieStatusRunICE 5	개별 ICE 실행.
ieStatusStarting 6	유효성 검사를 시작합니다.
ieStatusShutdown 7	ICE 실행을 완료합니다.
ieStatusSuccess 8	유효성 검사가 성공적으로 완료되었습니다.
ieStatusFail 9	유효성 검사에 실패했습니다.
ieStatusCancel 10	유효성 검사가 취소되었습니다.

szData

상태 적절한 정보를 포함하는 문자열 값입니다. szwData 값은 iStatus가 ieStatusICECount인 경우 실행 중인 ICE의 수여야 합니다. szwData 값은 iStatus가 ieStatusRunICE인 경우 실행 중인 ICE의 이름이어야 합니다. 그렇지 않으면 szwData 값은 NULL이어야 합니다. 콜백 함수는 이 매개 변수에 대해 가능한 값으로 NULL 을 허용해야 합니다.

pContext

SetStatus 메서드에 전달된 애플리케이션 컨텍스트에 대한 포인터입니다. 이 매개 변수는 오류 검사에 사용할 수 있습니다.

반환 값

반환 코드/값	설명
TRUE 1	유효성 검사 절차는 계속되어야 합니다.
FALSE 0	유효성 검사가 취소되었습니다. 콜백 함수는 FALSE 를 반환하여 유효성 검사를 중지합니다.

설명

SetStatus 메서드 및 LPEVALCOMCALLBACK을 사용하여 진행률 정보를 제공할 수 있습니다. 예를 들어 ieStatusICECount 메시지는 진행률 표시줄에 대한 전체 틱 수를 제공할 수 있습니다. 수신된 각 ieStatusRunICE 메시지에 대해 호출자는 진행률 표시줄을 1틱씩 증분할 수 있습니다.