PrjClearNegativePathCache, fonction (projectedfslib.h)

Vide le cache de chemin négatif de l’instance de virtualisation, s’il est actif.

Syntaxe

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

Paramètres

[in] namespaceVirtualizationContext

Handle opaque pour l’instance de virtualisation.

[out, optional] totalEntryNumber

Pointeur facultatif vers une variable qui reçoit le nombre de chemins d’accès qui se trouvaient dans le cache avant son purge.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

Si le cache de chemin d’accès négatif est actif, si le fournisseur indique qu’un chemin d’accès de fichier n’existe pas en retournant HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) à partir de son rappel PRJ_GET_PLACEHOLDER_INFO_CB , ProjFS échouera par la suite pour ouvrir ce chemin sans appeler à nouveau le rappel PRJ_GET_PLACEHOLDER_INFO_CB . Cela permet d’améliorer les performances des instances de virtualisation qui hébergent des charges de travail qui sondent fréquemment la présence d’un fichier en essayant de l’ouvrir.

Pour reprendre la réception du rappel PRJ_GET_PLACEHOLDER_INFO_CB pour les chemins d’accès indiqués par le fournisseur n’existe pas, le fournisseur doit appeler cette routine.

Spécifications