PrjClearNegativePathCache 関数 (projectedfslib.h)

仮想化インスタンスの負のパス キャッシュがアクティブな場合は消去します。

構文

HRESULT PrjClearNegativePathCache(
  [in]            PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [out, optional] UINT32                               *totalEntryNumber
);

パラメーター

[in] namespaceVirtualizationContext

仮想化インスタンスの不透明なハンドル。

[out, optional] totalEntryNumber

キャッシュが消去される前のパスの数を受け取る変数へのオプションのポインター。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

負のパス キャッシュがアクティブな場合、プロバイダーが PRJ_GET_PLACEHOLDER_INFO_CBコールバックから HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) を返すことによってファイル パスが存在しないことを示した場合、ProjFS は、PRJ_GET_PLACEHOLDER_INFO_CBコールバックを再度呼び出さずに、そのパスの後続のオープン に 失敗します。 これにより、ファイルを開こうとすることで、頻繁にファイルの存在をプローブするワークロードをホストする仮想化インスタンスのパフォーマンスが向上します。

プロバイダーが存在しないことを示したパスの PRJ_GET_PLACEHOLDER_INFO_CB コールバックの受信を再開するには、プロバイダーがこのルーチンを呼び出す必要があります。

要件