IMAPISupport::DoProgressDialogIMAPISupport::DoProgressDialog

適用されます: OutlookApplies to: Outlook

進行状況インジケーターを表示する進行中のオブジェクトを取得します。Retrieves a progress object that displays a progress indicator.

HRESULT DoProgressDialog(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPMAPIPROGRESS FAR * lppProgress
);

ParametersParameters

ulUIParamulUIParam

[in]進行状況インジケーターの親ウィンドウへのハンドル。[in] A handle to the parent window of the progress indicator.

ulFlagsulFlags

[in]オブジェクトの進行状況が進行状況を計算する方法を制御するフラグのビットマスクです。[in] A bitmask of flags that controls how the progress object should calculate progress. 次のフラグを設定することができます。The following flag can be set:

MAPI_TOP_LEVELMAPI_TOP_LEVEL

親フォルダーなどのトップレベルの項目の進行状況が計算されます。Progress is calculated for a top-level item, such as a parent folder. 進行中のオブジェクトは、 IMAPIProgress::Progressメソッドの_ulCount_および_ulTotal_パラメーターの値を使用する必要があります-現在の項目と、操作でアイテムの合計をそれぞれ指定する: 進行状況をインクリメントするのには操作のインジケーターです。The progress object should use the values in the IMAPIProgress::Progress method's ulCount and ulTotal parameters — which indicate the current item and the total items in the operation, respectively — to increment the progress indicator for the operation.

lppProgresslppProgress

[out]進行中のオブジェクトへのポインターへのポインター。[out] A pointer to a pointer to the progress object.

�߂�lReturn value

S_OKS_OK

進行中のオブジェクトが正常に取得しました。The progress object was successfully retrieved.

備考Remarks

アドレス帳、メッセージ ストア プロバイダーのサポート オブジェクトのIMAPISupport::DoProgressDialogメソッドを実装します。The IMAPISupport::DoProgressDialog method is implemented for address book and message store provider support objects. これらのプロバイダーは、MAPI インターフェイスの実装、 IMAPIProgress 、進捗状況の情報を計算し、標準のダイアログ ボックスを表示するにアクセスするためにDoProgressDialogを呼び出します。These providers call DoProgressDialog to access the MAPI implementation of the IMAPIProgress interface, which calculates the progress information and displays a standard dialog box.

進行中のオブジェクトと、 IMAPIProgressインターフェイスを使用する方法の詳細については、進行状況のインジケーターの表示を参照してください。For information about how to use a progress object and the IMAPIProgress interface, see Display a Progress Indicator.

関連項目See also

IMAPIProgress: IUnknownIMAPIProgress : IUnknown

IMAPIProgress::ProgressIMAPIProgress::Progress

IMAPISupport: IUnknownIMAPISupport : IUnknown

進行状況インジケーターを表示します。Display a Progress Indicator