プロバイダーの概要

プロバイダーは、バッキング データ ストアを維持および理解するユーザー モード アプリケーションです。 プロバイダーは ProjFS コールバックを実装し、ProjFS API を使用して、このデータ ストアをファイル とディレクトリとしてユーザーに表示されるファイル システムに投影します。 プロバイダーのバッキング ストアは、ユーザーのシステムに対してローカルであるか、リモートに配置されている可能性があります。

データプロジェクション

プロバイダーが所有するファイル システムの部分 (データが投影される場所) は、"仮想化ルート" と呼ばれるディレクトリにルート化されます。 プロバイダーがデータの投影を開始すると、"仮想化インスタンス" が開始されます。これは、特定の仮想化ルートの下にある一連のファイルとディレクトリのプロバイダーと ProjFS 間の通信を管理するオブジェクトです。 ユーザーによってローカルに作成されていない仮想化ルートの子孫であるファイルとディレクトリは、ProjFS API を介してプロバイダーによって具体化されます。 これらの項目は、仮想ファイルとディレクトリとして開始されます。つまり、ユーザーのローカル ストレージ デバイスには存在しませんが、ProjFS によって列挙結果に挿入されます。 アイテムを開いて読み取ると、ProjFS はプロバイダーによって実装されたコールバックを呼び出してデータを要求し、プロバイダーは ProjFS API を使用して、そのデータを後続のアクセス用にキャッシュされたローカル ストレージに送信します。 たとえば、データ ストアの内容が変更された場合など、バッキング データ ストアのユーザーのビューを変更する必要がある場合、プロバイダーは ProjFS API を使用してローカル アイテムを更新または削除して、データ ストアの新しいビューを反映できます。

コールバックリターンコード

各コールバックには、そのコールバックに固有の可能な戻り値の数が一覧表示されます。 コールバックは、特定のコールバックに対して一覧表示されている戻り値に加えて、他の特定のエラー コードも返す場合があります。 これは、コールバックが返す可能性があるエラー コードの完全な一覧です。

エラー コード	説明
S_OK	操作が成功しました
E_OUTOFMEMORY	必要なメモリを割り当てませんでした。
HRESULT_FROM_WIN32(ERROR_IO_PENDING)	プロバイダーは、後で操作を完了することを望みます。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	コールバックに渡されたバッファーが小さすぎます。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	ファイルはプロバイダーのバッキング ストアに存在しません。
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	コールバック引数が無効です。 たとえば、列挙 ID はアクティブな列挙セッションに対応していません。
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)	プロバイダーは、名前の変更や削除などの操作が行われるのを防ぐことを望みます。

コールバックは、ProjFS API への呼び出しから受け取る可能性のあるエラーも返す場合があります。 コールバックが、前の一覧にないエラー コード、または ProjFS API から取得されていないエラー コードを返す場合、ProjFS はSTATUS_INTERNAL_ERRORとしてファイル システムに返します。