Fonction PrjDeleteFile (projectedfslib.h)

Permet à un fournisseur de supprimer un élément qui a été mis en cache sur le système de fichiers local.

Syntaxe

HRESULT PrjDeleteFile(
  [in]            PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in]            PCWSTR                               destinationFileName,
  [in, optional]  PRJ_UPDATE_TYPES                     updateFlags,
  [out, optional] PRJ_UPDATE_FAILURE_CAUSES            *failureReason
);

Paramètres

[in] namespaceVirtualizationContext

Handle opaque pour le instance de virtualisation.

[in] destinationFileName

Chaîne Unicode terminée par null spécifiant le chemin d’accès, par rapport à la racine de virtualisation, au fichier ou au répertoire à supprimer.

[in, optional] updateFlags

Les indicateurs permettant de contrôler l’opération de suppression doivent être autorisés en fonction de l’état du fichier.

[out, optional] failureReason

Pointeur facultatif pour recevoir un code décrivant la raison de l’échec d’une suppression.

Valeur retournée

Si une erreur HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_VIRTUALIZATION_INVALID_OPERATION) est retournée, la mise à jour a échoué en raison de l’état de l’élément et de la valeur de updateFlags. failureReason, s’il est spécifié, décrit la raison de l’échec.

Remarques

Si l’élément se trouve toujours dans le magasin de stockage du fournisseur, sa suppression du système de fichiers local le transforme en élément virtuel.

Cette routine ne peut pas être appelée sur un fichier/répertoire virtuel.

Si le fichier/répertoire à supprimer est dans un état autre que « espace réservé », le fournisseur doit spécifier une combinaison appropriée de valeurs PRJ_UPDATE_TYPES dans le paramètre updateFlags. Cela permet de se prémunir contre la perte accidentelle de données.

Configuration requise