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 コールバックの受信を再開するには、プロバイダーがこのルーチンを呼び出す必要があります。

Requirements