PrjWritePlaceholderInfo-Funktion (projectedfslib.h)

Artikel
03/13/2024

Sendet Datei- oder Verzeichnismetadaten an ProjFS.

Syntax

HRESULT PrjWritePlaceholderInfo(
  [in] PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in] PCWSTR                               destinationFileName,
  [in] const PRJ_PLACEHOLDER_INFO           *placeholderInfo,
  [in] UINT32                               placeholderInfoSize
);

Parameter

[in] namespaceVirtualizationContext

Undurchsichtiges Handle für die Virtualisierung instance. Dies muss der Wert aus dem VirtualizationInstanceHandle-Member des CallbackData sein, das an den Anbieter im PRJ_GET_PLACEHOLDER_INFO_CB Rückrufs übergeben wird.

[in] destinationFileName

Eine Unicode-Zeichenfolge mit Null-Endung, die den Pfad relativ zum Virtualisierungsstamm zur Datei oder dem Verzeichnis angibt, für das ein Platzhalter erstellt werden soll.

Dies muss eine Übereinstimmung mit dem FilePathName-Member des callbackData-Parameters sein, der an den Anbieter im PRJ_GET_PLACEHOLDER_INFO_CB Rückruf übergeben wird. Der Anbieter sollte die PrjFileNameCompare-Funktion verwenden, um zu bestimmen, ob die beiden Namen übereinstimmen.

Wenn der PRJ_GET_PLACEHOLDER_INFO_CB-Rückruf beispielsweise "dir1\dir1\FILE.TXT" in callbackData-FilePathName> angibt und der Sicherungsspeicher des Anbieters eine Datei namens "File.txt" im Verzeichnis dir1\dir2 enthält und PrjFileNameCompare beim Vergleich der Namen "FILE.TXT" und "File.txt" eine Datei mit dem Namen "File.txt" enthält, gibt der Anbieter "dir1\dir2\File.txt" als Wert dieses Parameters an.

[in] placeholderInfo

Ein Zeiger auf die Metadaten für die Datei oder das Verzeichnis.

[in] placeholderInfoSize

Größe in Bytes des Puffers, auf den von placeholderInfo verwiesen wird.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Anbieter verwendet diese Routine, um die beim Aufruf seiner PRJ_GET_PLACEHOLDER_INFO_CB Rückruf angeforderten Daten bereitzustellen, oder er kann sie verwenden, um proaktiv einen Platzhalter festzulegen.

Die Mitglieder EaInformation, SecurityInformation und StreamsInformation von PRJ_PLACEHOLDER_INFO sind optional. Wenn der Anbieter keine erweiterten Attribute, benutzerdefinierten Sicherheitsdeskriptoren oder alternative Datenströme bereitstellen möchte, muss er diese Felder auf 0 festlegen.

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