Méthode IFileOperation ::SetOperationFlags (shobjidl_core.h)

Définit les paramètres de l’opération en cours.

Syntaxe

HRESULT SetOperationFlags(
  [in] DWORD dwOperationFlags
);

Paramètres

[in] dwOperationFlags

Type : DWORD

Indicateurs qui contrôlent l’opération de fichier. Ce membre peut être une combinaison des indicateurs suivants. Les indicateurs FOF sont définis dans Shellapi.h et les indicateurs FOFX sont définis dans Shobjidl.h.

FOF_ALLOWUNDO (0x0040)

Conservez les informations d’annulation, si possible.

Avant Windows Vista, les opérations ne pouvaient être annulées qu’à partir du même processus que celui qui effectuait l’opération d’origine.

Dans les systèmes Windows Vista et ultérieurs, l’étendue de l’annulation est une session utilisateur. Tout processus en cours d’exécution dans la session utilisateur peut annuler une autre opération. L’état d’annulation est conservé dans le processus Explorer.exe et tant que ce processus est en cours d’exécution, il peut coordonner les fonctions d’annulation.

Si le paramètre de fichier source ne contient pas de chemin d’accès complet et de noms de fichiers, cet indicateur est ignoré.

FOF_FILESONLY (0x0080)

Effectuez l’opération uniquement sur les fichiers (et non sur les dossiers) si un nom de fichier générique (.) est spécifié.

FOF_NOCONFIRMATION (0x0010)

Répondez avec Oui à Tous pour toute boîte de dialogue qui s’affiche.

FOF_NOCONFIRMMKDIR (0x0200)

Ne confirmez pas la création d’un nouveau dossier si l’opération nécessite d’en créer un.

FOF_NO_CONNECTED_ELEMENTS (0x2000)

Ne déplacez pas d’éléments connectés en tant que groupe. Déplacez uniquement les fichiers spécifiés.

FOF_NOCOPYSECURITYATTRIBS (0x0800)

Ne copiez pas les attributs de sécurité de l’élément.

FOF_NOERRORUI (0x0400)

N’affichez pas de message à l’utilisateur si une erreur se produit. Si cet indicateur est défini sans FOFX_EARLYFAILURE, toute erreur est traitée comme si l’utilisateur avait choisi Ignorer ou Continuer dans une boîte de dialogue. Il arrête l’action actuelle, définit un indicateur pour indiquer qu’une action a été abandonnée et continue avec le reste de l’opération.

FOF_NORECURSION (0x1000)

Fonctionnent uniquement dans le dossier local. N’effectuez pas d’opérations récursives dans les sous-répertoires.

FOF_RENAMEONCOLLISION (0x0008)

Donnez à l’élément en cours d’exploitation un nouveau nom dans une opération de déplacement, de copie ou de renommage si un élément portant le nom cible existe déjà.

FOF_SILENT (0x0004)

N’affichez pas de boîte de dialogue de progression.

FOF_WANTNUKEWARNING (0x4000)

Envoyez un avertissement si un fichier ou un dossier est détruit pendant une opération de suppression plutôt que recyclé. Cet indicateur remplace partiellement FOF_NOCONFIRMATION.

FOFX_ADDUNDORECORD (0x20000000)

Introduit dans Windows 8. L’opération de fichier a été appelée par l’utilisateur et doit être placée sur la pile d’annulation. Cet indicateur est préféré à FOF_ALLOWUNDO.

FOFX_NOSKIPJUNCTIONS (0x00010000)

Entrez dans les jonctions d’espace de noms Shell. Par défaut, les jonctions ne sont pas entrées. Pour plus d’informations sur les jonctions, consultez Spécification de l’emplacement d’une extension d’espace de noms.

FOFX_PREFERHARDLINK (0x00020000)

Si possible, créez un lien physique plutôt qu’une nouvelle instance du fichier dans la destination.

FOFX_SHOWELEVATIONPROMPT (0x00040000)

Si une opération nécessite des droits élevés et que l’indicateur FOF_NOERRORUI est défini pour désactiver l’interface utilisateur d’erreur, affichez néanmoins une invite d’interface utilisateur UAC.

FOFX_EARLYFAILURE (0x00100000)

Si FOFX_EARLYFAILURE est défini avec FOF_NOERRORUI, l’ensemble des opérations est arrêté en cas d’erreur dans une opération. Cet indicateur n’est valide que lorsque FOF_NOERRORUI est défini.

FOFX_PRESERVEFILEEXTENSIONS (0x00200000)

Renommez les collisions de manière à préserver les extensions de nom de fichier. Cet indicateur n’est valide que lorsque FOF_RENAMEONCOLLISION est également défini.

FOFX_KEEPNEWERFILE (0x00400000)

Conservez le fichier ou dossier le plus récent, en fonction de la propriété Date Modified, en cas de collision. Cette opération est effectuée automatiquement sans qu’aucune interface utilisateur d’invite ne soit présentée à l’utilisateur.

FOFX_NOCOPYHOOKS (0x00800000)

N’utilisez pas de crochets de copie.

FOFX_NOMINIMIZEBOX (0x01000000)

N’autorisez pas la réduction de la boîte de dialogue de progression.

FOFX_MOVEACLSACROSSVOLUMES (0x02000000)

Copiez les attributs de sécurité de l’élément source dans l’élément de destination lors de l’exécution d’une opération de déplacement entre volumes. Sans cet indicateur, l’élément de destination reçoit les attributs de sécurité de son nouveau dossier.

FOFX_DONTDISPLAYSOURCEPATH (0x04000000)

N’affichez pas le chemin d’accès de l’élément source dans la boîte de dialogue de progression.

FOFX_DONTDISPLAYDESTPATH (0x08000000)

N’affichez pas le chemin d’accès de l’élément de destination dans la boîte de dialogue de progression.

FOFX_RECYCLEONDELETE (0x00080000)

Introduit dans Windows 8. Lorsqu’un fichier est supprimé, envoyez-le à la Corbeille plutôt que de le supprimer définitivement.

FOFX_REQUIREELEVATION (0x10000000)

Introduit dans Windows Vista SP1. L’utilisateur s’attend à une exigence d’élévation de droits. Par conséquent, n’affichez pas de boîte de dialogue demandant une confirmation de l’élévation.

FOFX_COPYASDOWNLOAD (0x40000000)

Introduit dans Windows 7. Affichez un message Téléchargement au lieu de copier dans la boîte de dialogue de progression.

FOFX_DONTDISPLAYLOCATIONS (0x80000000)

Introduit dans Windows 7. N’affichez pas la ligne d’emplacement dans la boîte de dialogue de progression.

Valeur retournée

Type : HRESULT

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

Remarques

Définissez ces indicateurs avant d’appeler IFileOperation ::P erformOperations pour définir les paramètres des opérations effectuées, telles que la copie, la suppression ou le renommage.

Configuration requise