進行状況をユーザーに表示する必要があるアクションが開始されたときに呼び出されます。
構文
HRESULT Begin(
[in] SPACTION action,
[in] SPBEGINF flags
);
パラメーター
[in] action
種類: SPACTION
実行されているアクション。 許容される値の一覧については、「 SPACTION 」を参照してください。
[in] flags
種類: SPBEGINF
特定の UI 操作を有効または無効にすることを要求する省略可能なフラグ。 許容される値の一覧については、 SPBEGINF を参照してください。
戻り値
型: HRESULT
成功した場合はS_OKを返し、それ以外の場合はエラー値を返します。
注釈
このメソッドは、アクションの開始時に呼び出す必要があります。 アクションとフラグの値を使用して、ユーザーに表示される UI を描画する方法、またはアクションに関連付けられている特定のユーザー アクションを解釈またはフィルター処理する方法を決定できます。 アクションが完了したら、 IActionProgress::End を呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |
| [DLL] | Shobjidl.idl |