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 尚未設定為虛擬化根目錄。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1809 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | projectedfslib.h |