ホーム › System.ApplicationInstallationAndServicing › LPEVALCOMCALLBACK

LPEVALCOMCALLBACK

コールバック

シグネチャ

BOOL LPEVALCOMCALLBACK(
    STATUSTYPES iStatus,
    LPWSTR szData,
    void* pContext
);

パラメーター

フィールド

型

説明

iStatus

STATUSTYPES

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

LPWSTR

ステータスに応じた情報を含む文字列値です。iStatus が ieStatusICECount の場合、szwData の値は実行される ICE の数になります。iStatus が ieStatusRunICE の場合、szwData の値は実行中の ICE の名前になります。それ以外の場合、szwData の値は NULL になります。コールバック関数は、このパラメーターの値として NULL を受け入れられるようにする必要があります。

pContext

void*

SetStatus メソッドに渡されたアプリケーションコンテキストへのポインターです。このパラメーターはエラーチェックに使用できます。

公式ドキュメント

LPEVALCOMCALLBACK の仕様は、コールバック関数のプロトタイプを定義します。IValidate::SetStatus メソッドにより、オーサリングツールは登録されたコールバック関数を通じて検証の進行状況に関する情報を受け取ることができます。

戻り値

リターンコード/値	説明
TRUE 1	検証処理を続行します。
FALSE 0	検証がキャンセルされました。検証を中止するには、コールバック関数は FALSE を返します。

解説(Remarks)

SetStatus メソッドと LPEVALCOMCALLBACK は、進行状況の情報を提供するために使用できます。たとえば、ieStatusICECount メッセージは、進行状況バーの全体のティック数を提供できます。 ieStatusRunICE メッセージを受け取るたびに、呼び出し元は進行状況バーを 1 ティック進めることができます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)