PrjDeleteFile-Funktion (projectedfslib.h)

Ermöglicht es einem Anbieter, ein Element zu löschen, das im lokalen Dateisystem zwischengespeichert wurde.

Syntax

HRESULT PrjDeleteFile(
  [in]            PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in]            PCWSTR                               destinationFileName,
  [in, optional]  PRJ_UPDATE_TYPES                     updateFlags,
  [out, optional] PRJ_UPDATE_FAILURE_CAUSES            *failureReason
);

Die Parameter

[in] namespaceVirtualizationContext

Ein undurchsichtiges Handle für die Virtualisierungsinstanz.

[in] destinationFileName

Eine mit Null beendete Unicode-Zeichenfolge, die den Pfad relativ zum Virtualisierungsstamm angibt, zu der Datei oder dem Verzeichnis, die gelöscht werden soll.

[in, optional] updateFlags

Flags zum Steuern des Löschvorgangs sollten im Zustand der Datei zulässig sein.

[out, optional] failureReason

Optionaler Zeiger zum Empfangen eines Codes, der den Grund für einen Fehler beim Löschen beschreibt.

Rückgabewert

Wenn ein HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_VIRTUALIZATION_INVALID_OPERATION)-Fehler zurückgegeben wird, ist das Update aufgrund des Status des Elements und des Werts von updateFlags fehlgeschlagen. failureReason, falls angegeben, beschreibt den Grund für den Fehler.

Bemerkungen

Wenn sich das Element noch im Sicherungsspeicher des Anbieters befindet, ändert es das Löschen aus dem lokalen Dateisystem in ein virtuelles Element.

Diese Routine kann nicht für eine virtuelle Datei/ein virtuelles Verzeichnis aufgerufen werden.

Wenn sich die zu löschende Datei/das zu löschende Verzeichnis in einem anderen Zustand als "Platzhalter" befindet, muss der Anbieter eine geeignete Kombination aus PRJ_UPDATE_TYPES Werten im Parameter updateFlags angeben. Dadurch können Sie vor versehentlichem Verlust von Daten schützen.

Anforderungen