IActionProgress::Begin-Methode (shobjidl_core.h)

Artikel
03/02/2024

Wird aufgerufen, wenn eine Aktion gestartet wurde, für die der Fortschritt für den Benutzer angezeigt werden muss.

Syntax

HRESULT Begin(
  [in] SPACTION action,
  [in] SPBEGINF flags
);

Parameter

[in] action

Typ: SPACTION

Die ausgeführte Aktion. Eine Liste der zulässigen Werte finden Sie unter SPACTION .

[in] flags

Typ: SPBEGINF

Optionale Flags, die anfordern, dass bestimmte Benutzeroberflächenvorgänge aktiviert oder deaktiviert werden. Eine Liste der zulässigen Werte finden Sie unter SPBEGINF .

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich, oder andernfalls einen Fehlerwert.

Hinweise

Diese Methode sollte aufgerufen werden, wenn eine Aktion beginnt. Die Werte von Aktion und Flags können verwendet werden, um zu bestimmen, wie die Benutzeroberfläche gezeichnet werden soll, die dem Benutzer angezeigt wird, oder wie bestimmte Benutzeraktionen interpretiert oder gefiltert werden, die der Aktion zugeordnet sind. Wenn die Aktion abgeschlossen ist, sollte IActionProgress::End aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shobjidl.idl

Weitere Informationen