IActionProgress::Begin-Methode (shobjidl_core.h)
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 |