PrjStartVirtualizing-Funktion (projectedfslib.h)

Konfiguriert eine ProjFS-Virtualisierungsinstanz und startet sie, wodurch sie für Dienst-E/A verfügbar gemacht 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
);

Die Parameter

[in] virtualizationRootPath

Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, die den vollständigen Pfad zum Virtualisierungsstammverzeichnis angibt.

Der Anbieter muss prjMarkDirectoryAsPlaceholder aufgerufen haben, der den angegebenen Pfad als rootPathName-Parameter und NULL als targetPathName-Parameter vor dem Aufrufen dieser Routine übergeben hat. 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 gefüllt wurde.

[in, optional] instanceContext

Zeiger auf Kontextinformationen, die vom Anbieter für jede Instanz definiert wurden. Dieser Parameter ist optional und kann NULL sein. Wenn sie angegeben ist, gibt ProjFS sie im InstanceContext-Element 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 für die ProjFS-Virtualisierungsinstanz zurückgegeben. Der Anbieter übergibt diesen Wert, wenn Funktionen aufgerufen werden, 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