Freigeben über


PrjGetOnDiskFileState-Funktion (projectedfslib.h)

Ruft den Dateistatus auf dem Datenträger für eine Datei oder ein Verzeichnis ab.

Syntax

HRESULT PrjGetOnDiskFileState(
  [in]  PCWSTR         destinationFileName,
  [out] PRJ_FILE_STATE *fileState
);

Parameter

[in] destinationFileName

Eine mit NULL endende Unicode-Zeichenfolge, die den vollständigen Pfad zu der Datei angibt, deren Zustand abgefragt werden soll.

[out] fileState

Dies ist eine Kombination aus einem oder mehreren PRJ_FILE_STATE Werten, die den Dateizustand beschreiben.

Rückgabewert

HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) gibt an, dass destinationFileName nicht vorhanden ist. HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) gibt an, dass keine Zwischenkomponente des Pfads zu destinationFileName vorhanden ist.

Hinweise

Diese Routine teilt dem Aufrufer mit, wie der ProjFS-Zwischenspeicherungsstatus der angegebenen Datei oder des angegebenen Verzeichnisses ist. Beispielsweise kann der Aufrufer diese Routine verwenden, um zu bestimmen, ob das angegebene Element ein Platzhalter oder eine vollständige Datei ist.

Ein ausgeführter Anbieter sollte vorsichtig sein, wenn diese Routine für Dateien oder Verzeichnisse in einer seiner Virtualisierungsinstanzen verwendet wird, da dies dazu führen kann, dass Rückrufe im Anbieter aufgerufen werden. Je nach Design des Anbieters kann dies zu Deadlocks führen.

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