PrjMarkDirectoryAsPlaceholder-Funktion (projectedfslib.h)

Artikel
03/01/2024

Konvertiert ein vorhandenes Verzeichnis in einen Verzeichnisplatzhalter.

Syntax

HRESULT PrjMarkDirectoryAsPlaceholder(
  [in]           PCWSTR                             rootPathName,
  [in, optional] PCWSTR                             targetPathName,
  [in, optional] const PRJ_PLACEHOLDER_VERSION_INFO *versionInfo,
  [in]           const GUID                         *virtualizationInstanceID
);

Parameter

[in] rootPathName

Eine mit Null beendete Unicode-Zeichenfolge, die den vollständigen Pfad zum Virtualisierungsstamm angibt.

[in, optional] targetPathName

Eine Unicode-Zeichenfolge mit Null-Endung, die den vollständigen Pfad zum Verzeichnis angibt, das in einen Platzhalter konvertiert werden soll.

Wenn dieser Parameter nicht angegeben oder eine leere Zeichenfolge ist, bedeutet dies, dass der Aufrufer rootPathName als Virtualisierungsstamm festlegen möchte. Der Anbieter muss dies nur einmal tun, wenn er eine neue Virtualisierung instance.

[in, optional] versionInfo

Optionale Versionsinformationen für den Zielplatzhalter. Der Anbieter wählt aus, welche Informationen in die PRJ_PLACEHOLDER_VERSION_INFO-Struktur eingefügt werden sollen. Wenn nicht angegeben, erhält der Platzhalter Nullen für seine Versionsinformationen.

[in] virtualizationInstanceID

Ein Wert, der die Virtualisierungs-instance identifiziert.

Rückgabewert

HRESULT_FROM_WIN32(ERROR_REPARSE_POINT_ENCOUNTERED) bedeutet in der Regel, dass das Verzeichnis bei targetPathName über einen Analysepunkt verfügt. HRESULT_FROM_WIN32(ERROR_DIRECTORY) bedeutet in der Regel, dass targetPathName kein Verzeichnis angibt.

Hinweise

Der Anbieter muss diese API verwenden, um den Virtualisierungsstamm festzulegen, bevor PrjStartVirtualizing aufgerufen wird.

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