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 文字列へのポインター。
プロバイダーは、このルーチンを呼び出す前に、指定したパスを rootPathName パラメーターとして渡し、NULL を targetPathName パラメーターとして渡す PrjMarkDirectoryAsPlaceholder を呼び出す必要があります。 これは、パスを仮想化ルート ディレクトリとして指定するために 1 回だけ行う必要があります
[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 Version 1809 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | projectedfslib.h |