PrjDeleteFile-Funktion (projectedfslib.h)

Artikel
08/25/2023

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
);

Parameter

[in] namespaceVirtualizationContext

Ein undurchsichtiges Handle für die Virtualisierung instance.

[in] destinationFileName

Eine mit NULL endende Unicode-Zeichenfolge, die den Pfad relativ zum Virtualisierungsstamm zur zu löschenden Datei oder zum zu löschenden Verzeichnis angibt.

[in, optional] updateFlags

Flags zum Steuern des Löschvorgangs sollten angesichts des Status 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 Zustands des Elements und des Werts von updateFlags fehlgeschlagen. failureReason, sofern angegeben, beschreibt den Grund für den Fehler.

Hinweise

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

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. Dies schützt vor versehentlichem Datenverlust.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	projectedfslib.h

Freigeben über