Méthode IStorageProviderCopyHook::CopyCallback

Article
06/13/2023

Détermine si l’interpréteur de commandes sera autorisé à déplacer, copier, supprimer ou renommer un dossier dans la racine de synchronisation d’un fournisseur de cloud.

Syntaxe

HRESULT CopyCallback( 
    HWND hwnd,
    UINT operation,
    UINT flags,
    LPCWSTR srcFile,
    DWORD srcAttribs,
    LPCWSTR destFile,
    DWORD destAttribs,
    UINT* result
);

Paramètres

hwnd [in]: Handle de la fenêtre que le gestionnaire de crochet de copie doit utiliser comme parent pour tous les éléments d’interface utilisateur que le gestionnaire peut avoir besoin d’afficher. Si FOF_SILENT est spécifié dans l’opération, la méthode doit ignorer ce paramètre.

operation [in]: Opération à exécuter. Ce paramètre peut être l’une des valeurs répertoriées sous le membre wFunc de la structure SHFILEOPSTRUCT .

indicateurs [in]

Indicateurs qui contrôlent l’opération. Ce paramètre peut être une ou plusieurs des valeurs répertoriées sous le membre fFlags de la structure SHFILEOPSTRUCT .

Pour les hooks de copie d’imprimante, cette valeur est l’une des valeurs suivantes définies dans shellapi.h.

Valeur	Description
PO_DELETE	Une imprimante est en cours de suppression. Le paramètre srcFile pointe vers le chemin d’accès complet à l’imprimante spécifiée.
PO_RENAME	Une imprimante est en cours de renommage. Le paramètre srcFile pointe vers le nouveau nom de l’imprimante. Le paramètre destFile pointe vers l’ancien nom.
PO_PORTCHANGE	Non pris en charge. Ne pas utiliser.
PO_REN_PORT	Non pris en charge. Ne pas utiliser.

srcFile [in]: Pointeur vers une chaîne qui contient le nom du dossier source.

srcAttribs [in]

Attributs du dossier source. Ce paramètre peut être une combinaison de l’un des indicateurs d’attribut de fichier (FILE_ATTRIBUTE_*) définis dans les fichiers d’en-tête. Consultez Constantes d’attributs de fichier.

destFile [in]

Pointeur vers une chaîne qui contient le nom du dossier de destination.

destAttribs [in]

Attributs du dossier de destination. Ce paramètre peut être une combinaison de l’un des indicateurs d’attribut de fichier (FILE_ATTRIBUTE_*) définis dans les fichiers d’en-tête. Consultez Constantes d’attributs de fichier.

result [out]

Valeur entière qui indique si l’interpréteur de commandes doit effectuer l’opération. Celui-ci peut avoir l'une des valeurs suivantes :

Value	Description
IDYES	Autorise l’opération.
IDNO	Empêche l’opération sur ce dossier, mais continue avec toutes les autres opérations qui ont été approuvées (par exemple, une opération de copie par lots).
IDCANCEL	Empêche l’opération en cours et annule toutes les opérations en attente.

Valeur retournée

Retourne S_OK en cas de réussite, ou un code d’erreur dans le cas contraire.

Notes

L’interpréteur de commandes appelle le gestionnaire de hook de copie du fournisseur de cloud pour chaque dossier sous la racine de synchronisation inscrite. Pour inscrire un gestionnaire de hook de copie pour les dossiers cloud, définissez la valeur CopyHook sous la clé HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Explorer/SyncRootManager/{SyncRootId} sur le CLSID de l’objet de crochet de copie.

Lorsque la méthode CopyCallback est appelée, l’interpréteur de commandes initialise directement l’interface IStorageProviderCopyHook sans utiliser d’abord une interface IShellExtInit .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Insider Preview Build 19624
En-tête	shobjidl.h

Voir aussi

Créer un moteur de synchronisation cloud qui prend en charge les fichiers d’espace réservé

Partager via