PrjWritePlaceholderInfo-Funktion (projectedfslib.h)

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

Die Parameter

[in] namespaceVirtualizationContext

Undurchsichtiges Handle für die Virtualisierungsinstanz. Dies muss der Wert aus dem VirtualizationInstanceHandle-Element des callbackData-Elements sein, das an den Anbieter im PRJ_GET_PLACEHOLDER_INFO_CB Rückruf übergeben wird.

[in] destinationFileName

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

Dies muss eine Übereinstimmung mit dem FilePathName-Element 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.

Beispiel: wenn der PRJ_GET_PLACEHOLDER_INFO_CB Rückruf "dir1\dir1\FILE.TXT" in callbackData-FilePathName> angibt, und der Sicherungsspeicher des Anbieters enthält eine Datei namens "File.txt" im Verzeichnis dir1\dir2, und PrjFileNameCompare gibt 0 zurück, wenn die Namen "FILE.TXT" und "File.txt" verglichen werden, 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 Byte des Puffers, auf den durch PlaceholderInfo verwiesen wird.

Rückgabewert

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

Bemerkungen

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

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

Anforderungen