Share via

IFileOperation::SetOperationFlags-Methode (shobjidl_core.h)

  • Artikel

Legt Parameter für den aktuellen Vorgang fest.

Syntax

HRESULT SetOperationFlags(
  [in] DWORD dwOperationFlags
);

Parameter

[in] dwOperationFlags

Art: DWORD

Flags, die den Dateivorgang steuern. Dieser Member kann eine Kombination der folgenden Flags sein. FOF-Flags werden in Shellapi.h und FOFX-Flags in Shobjidl.h definiert.

Hinweis Wenn diese Methode nicht aufgerufen wird, ist der vom Vorgang verwendete Standardwert FOF_ALLOWUNDO | FOF_NOCONFIRMMKDIR.
 

FOF_ALLOWUNDO (0x0040)

Behalten Sie nach Möglichkeit Informationen zum Rückgängigmachen bei.

Vor Windows Vista konnten Vorgänge nur aus demselben Prozess rückgängig gemacht werden, der den ursprünglichen Vorgang ausgeführt hat.

In Windows Vista- und höheren Systemen ist der Bereich des Rückgängigmachens eine Benutzersitzung. Jeder Prozess, der in der Benutzersitzung ausgeführt wird, kann einen anderen Vorgang rückgängigmachen. Der Rückgängigzustand wird im Explorer.exe-Prozess gespeichert, und solange dieser Prozess ausgeführt wird, kann er die Rückgängig-Funktionen koordinieren.

Wenn der Quelldateiparameter keine vollqualifizierten Pfad- und Dateinamen enthält, wird dieses Flag ignoriert.

FOF_FILESONLY (0x0080)

Führen Sie den Vorgang nur für Dateien (nicht für Ordner) aus, wenn ein Feldhalterdateiname (.) angegeben ist.

FOF_NOCONFIRMATION (0x0010)

Antworten Sie mit Ja auf Alle für jedes angezeigte Dialogfeld.

FOF_NOCONFIRMMKDIR (0x0200)

Bestätigen Sie die Erstellung eines neuen Ordners nicht, wenn für den Vorgang ein Ordner erstellt werden muss.

FOF_NO_CONNECTED_ELEMENTS (0x2000)

Verschieben Sie verbundene Elemente nicht als Gruppe. Verschieben Sie nur die angegebenen Dateien.

FOF_NOCOPYSECURITYATTRIBS (0x0800)

Kopieren Sie die Sicherheitsattribute des Elements nicht.

FOF_NOERRORUI (0x0400)

Zeigen Sie dem Benutzer keine Meldung an, wenn ein Fehler auftritt. Wenn dieses Flag ohne FOFX_EARLYFAILURE festgelegt ist, wird jeder Fehler so behandelt, als hätte der Benutzer in einem Dialogfeld Ignorieren oder Fortfahren ausgewählt. Es beendet die aktuelle Aktion, legt ein Flag fest, um anzugeben, dass eine Aktion abgebrochen wurde, und fährt mit dem Rest des Vorgangs fort.

FOF_NORECURSION (0x1000)

Arbeiten Sie nur im lokalen Ordner. Arbeiten Sie nicht rekursiv in Unterverzeichnissen.

FOF_RENAMEONCOLLISION (0x0008)

Geben Sie dem Element, das mit einem neuen Namen in einem Verschiebungs-, Kopier- oder Umbenennungsvorgang ausgeführt wird, wenn bereits ein Element mit dem Zielnamen vorhanden ist.

FOF_SILENT (0x0004)

Zeigt kein Statusdialogfeld an.

FOF_WANTNUKEWARNING (0x4000)

Senden Sie eine Warnung, wenn eine Datei oder ein Ordner während eines Löschvorgangs zerstört wird, anstatt sie zu recyceln. Dieses Flag überschreibt teilweise FOF_NOCONFIRMATION.

FOFX_ADDUNDORECORD (0x20000000)

In Windows 8 eingeführt. Der Dateivorgang wurde vom Benutzer aufgerufen und sollte auf dem Rückgängigstapel platziert werden. Dieses Flag wird bevorzugt FOF_ALLOWUNDO.

FOFX_NOSKIPJUNCTIONS (0x00010000)

Gehen Sie zu Shell-Namespaceverbindungen. Standardmäßig werden Keine Verzweigungen eingegeben. Weitere Informationen zu Knoten finden Sie unter Angeben des Speicherorts einer Namespaceerweiterung.

Erstellen Sie nach Möglichkeit einen harten Link anstelle eines neuen instance der Datei im Ziel.

FOFX_SHOWELEVATIONPROMPT (0x00040000)

Wenn für einen Vorgang erhöhte Rechte erforderlich sind und das FOF_NOERRORUI-Flag auf die Deaktivierung der Fehlerbenutzeroberfläche festgelegt ist, wird trotzdem eine UAC-Ui-Eingabeaufforderung angezeigt.

FOFX_EARLYFAILURE (0x00100000)

Wenn FOFX_EARLYFAILURE zusammen mit FOF_NOERRORUI festgelegt ist, wird der gesamte Satz von Vorgängen beendet, sobald ein Fehler in einem Vorgang auftritt. Dieses Flag ist nur gültig, wenn FOF_NOERRORUI festgelegt ist.

FOFX_PRESERVEFILEEXTENSIONS (0x00200000)

Benennen Sie Kollisionen so um, dass Dateinamenerweiterungen beibehalten werden. Dieses Flag ist nur gültig, wenn FOF_RENAMEONCOLLISION ebenfalls festgelegt ist.

FOFX_KEEPNEWERFILE (0x00400000)

Behalten Sie die neuere Datei oder den neueren Ordner basierend auf der Date Modified-Eigenschaft bei, wenn eine Kollision auftritt. Dies geschieht automatisch, ohne dass dem Benutzer eine Eingabeaufforderung angezeigt wird.

FOFX_NOCOPYHOOKS (0x00800000)

Verwenden Sie keine Kopierhaken.

FOFX_NOMINIMIZEBOX (0x01000000)

Lassen Sie nicht zu, dass das Statusdialogfeld minimiert wird.

FOFX_MOVEACLSACROSSVOLUMES (0x02000000)

Kopieren Sie die Sicherheitsattribute des Quellelements in das Zielelement, wenn Sie einen volumeübergreifenden Verschiebungsvorgang ausführen. Ohne dieses Flag empfängt das Zielelement die Sicherheitsattribute des neuen Ordners.

FOFX_DONTDISPLAYSOURCEPATH (0x04000000)

Zeigen Sie den Pfad des Quellelements nicht im Statusdialogfeld an.

FOFX_DONTDISPLAYDESTPATH (0x08000000)

Zeigen Sie den Pfad des Zielelements nicht im Statusdialogfeld an.

FOFX_RECYCLEONDELETE (0x00080000)

In Windows 8 eingeführt. Wenn eine Datei gelöscht wird, senden Sie sie an den Papierkorb, anstatt sie endgültig zu löschen.

FOFX_REQUIREELEVATION (0x10000000)

In Windows Vista SP1 eingeführt. Der Benutzer erwartet eine Anforderung für die Rechteerweiterung, daher wird kein Dialogfeld angezeigt, in dem eine Bestätigung der Erhöhung gefordert wird.

FOFX_COPYASDOWNLOAD (0x40000000)

In Windows 7 eingeführt. Zeigen Sie im Statusdialogfeld die Meldung Herunterladen statt Kopieren an.

FOFX_DONTDISPLAYLOCATIONS (0x80000000)

In Windows 7 eingeführt. Zeigen Sie die Position nicht im Statusdialogfeld an.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Legen Sie diese Flags fest, bevor Sie IFileOperation::P erformOperations aufrufen, um die Parameter für alle ausgeführten Vorgänge wie Kopieren, Löschen oder Umbenennen zu definieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)