PRJ_GET_PLACEHOLDER_INFO_CB Rückruffunktion (projectedfslib.h)

Artikel
03/06/2024

Fordert Informationen für eine Datei oder ein Verzeichnis vom Anbieter an.

Syntax

PRJ_GET_PLACEHOLDER_INFO_CB PrjGetPlaceholderInfoCb;

HRESULT PrjGetPlaceholderInfoCb(
  [in] const PRJ_CALLBACK_DATA *callbackData
)
{...}

Parameter

[in] callbackData

Informationen zum Vorgang. Die folgenden callbackData-Member sind erforderlich, um diesen Rückruf zu implementieren:

FilePathName Gibt den Pfad zu der Datei oder dem Verzeichnis im Speicher des Anbieters an, für den ProjFS Informationen anfordert.

Der Anbieter verwendet dies, um zu bestimmen, ob der Name in seinem Sicherungsspeicher vorhanden ist. Es sollte die PrjFileNameMatch-Funktion verwenden, um diesen Namen mit den Namen in seinem Speicher zu vergleichen. Wenn er einen übereinstimmenden Namen findet, wird dieser Name als destinationFileName-Parameter der PrjWritePlaceholderInfo-Funktion verwendet.

VersionInfo Stellt Versionsinformationen für das übergeordnete Verzeichnis des angeforderten Elements bereit.

Der Anbieter kann nur während der Ausführung des Rückrufs auf diesen Puffer zugreifen. Wenn er den Vorgang mit stiften möchte und Daten aus diesem Puffer benötigt, muss er eine eigene Kopie davon erstellen.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Datei ist im Speicher des Anbieters vorhanden und hat die Informationen der Datei erfolgreich an ProjFS gegeben.
HRESULT_FROM_WIN32(ERROR_IO_PENDING)	Der Anbieter möchte den Vorgang zu einem späteren Zeitpunkt abschließen.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Die Datei ist im Speicher des Anbieters nicht vorhanden.

Ein weiterer geeigneter HRESULT-Fehlercode, wenn der Anbieter den Vorgang fehlschlägt.

Hinweise

ProjFS verwendet die in diesem Rückruf bereitgestellten Informationen, um einen Platzhalter für das angeforderte Element zu erstellen.

Um diesen Rückruf zu verarbeiten, ruft der Anbieter PrjWritePlaceholderInfo auf, um ProjFS die Informationen für den angeforderten Dateinamen zu geben. Anschließend schließt der Anbieter den Rückruf ab.

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