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 が仮想化ルートとして構成されていないことを示します。

Requirements