PrjStartVirtualizing 函數 （projectedfslib.h）

設定 ProjFS 虛擬化實例並啟動它，使其可用於服務 I/O 並在提供者上叫用回呼。

語法

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

參數

[in] virtualizationRootPath

以 Null 結尾的 Unicode 字串的指標，指定虛擬化根目錄的完整路徑。

提供者必須呼叫 PrjMarkDirectoryAsPlaceholder ，將指定的路徑傳遞為 rootPathName 參數，並將 Null 作為 targetPathName 參數，才能呼叫此常式。 這只需要執行一次，即可將路徑指定為虛擬化根目錄

[in] callbacks

已填入提供者回呼函式指標的 PRJ_CALLBACKS 結構指標。

[in, optional] instanceContext

提供者為每個實例定義的內容資訊指標。 這個參數是選擇性的，而且可以是 NULL。 如果指定，ProjFS 會在叫用提供者回呼常式時，在 PRJ_CALLBACK_DATA 的 InstanceContext 成員中傳回它。

[in, optional] options

指向 PRJ_STARTVIRTUALIZING_OPTIONS的選擇性指標。

[out] namespaceVirtualizationContext

成功時，會將不透明控制碼傳回至 ProjFS 虛擬化實例。 提供者會在呼叫需要PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT作為輸入的函式時傳遞此值。

返回值

錯誤 HRESULT_FROM_WIN32（ERROR_REPARSE_TAG_MISMATCH） 表示 virtualizationRootPath 尚未設定為虛擬化根目錄。

需求