IActionProgress::Begin 方法 (shobjidl_core.h)

當動作開始需要向用戶顯示其進度時呼叫。

語法

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

另請參閱

IActionProgress

IActionProgress::End

SPACTION

SPBEGINF