Freigeben über

PrjStartVirtualizing-Funktion (projectedfslib.h)

  • Artikel

Konfiguriert eine ProjFS-Virtualisierungs-instance und startet sie, sodass es für Dienst-E/A verfügbar ist und Rückrufe für den Anbieter aufgerufen werden.

Syntax

HRESULT PrjStartVirtualizing(
  [in]           PCWSTR                               virtualizationRootPath,
  [in]           const PRJ_CALLBACKS                  *callbacks,
  [in, optional] const void                           *instanceContext,
  [in, optional] const PRJ_STARTVIRTUALIZING_OPTIONS  *options,
  [out]          PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT *namespaceVirtualizationContext
);

Parameter

[in] virtualizationRootPath

Zeiger auf eine Unicode-Zeichenfolge, die null beendet ist und den vollständigen Pfad zum Virtualisierungsstammverzeichnis angibt.

Der Anbieter muss PrjMarkDirectoryAsPlaceholder aufgerufen haben und den angegebenen Pfad als rootPathName-Parameter und NULL als targetPathName-Parameter übergeben, bevor diese Routine aufgerufen wird. Dies muss nur einmal erfolgen, um den Pfad als Virtualisierungsstammverzeichnis festzulegen.

[in] callbacks

Zeiger auf eine PRJ_CALLBACKS-Struktur , die mit Zeigern auf die Rückruffunktionen des Anbieters ausgefüllt wurde.

[in, optional] instanceContext

Zeiger auf kontextbezogene Informationen, die vom Anbieter für jede instance definiert wurden. Dieser Parameter ist optional und kann NULL sein. Wenn sie angegeben ist, gibt ProjFS sie im InstanceContext-Member von PRJ_CALLBACK_DATA zurück, wenn Anbieterrückrufroutinen aufgerufen werden.

[in, optional] options

Ein optionaler Zeiger auf eine PRJ_STARTVIRTUALIZING_OPTIONS.

[out] namespaceVirtualizationContext

Bei Erfolg wird ein undurchsichtiges Handle an die ProjFS-Virtualisierungs-instance zurückgegeben. Der Anbieter übergibt diesen Wert beim Aufrufen von Funktionen, die eine PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT als Eingabe erfordern.

Rückgabewert

Der Fehler HRESULT_FROM_WIN32(ERROR_REPARSE_TAG_MISMATCH) gibt an, dass virtualizationRootPath nicht als Virtualisierungsstamm konfiguriert wurde.

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