ICopyHookW ::CopyCallback, méthode (shlobj.h)

Article
03/04/2024

Détermine si l’interpréteur de commandes sera autorisé à déplacer, copier, supprimer ou renommer un dossier ou un objet d’imprimante.

Syntaxe

UINT CopyCallback(
  HWND   hwnd,
  UINT   wFunc,
  UINT   wFlags,
  PCWSTR pszSrcFile,
  DWORD  dwSrcAttribs,
  PCWSTR pszDestFile,
  DWORD  dwDestAttribs
);

Paramètres

hwnd

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 wFunc, la méthode doit ignorer ce paramètre.

wFunc

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

wFlags

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. pszSrcFile pointe vers le chemin complet de l’imprimante spécifiée.
PO_RENAME	Une imprimante est en cours de renommage. Le paramètre pszSrcFile pointe vers le nouveau nom de l’imprimante. Le paramètre pszDestFile pointe vers l’ancien nom.
PO_PORTCHANGE	Non pris en charge. Ne pas utiliser.
PO_REN_PORT	Non pris en charge. Ne pas utiliser.

pszSrcFile

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

dwSrcAttribs

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

pszDestFile

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

dwDestAttribs

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

Valeur retournée

Retourne une 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.

Remarques

L’interpréteur de commandes appelle chaque gestionnaire de crochet de copie inscrit pour un dossier ou un objet d’imprimante jusqu’à ce que tous les gestionnaires aient été appelés, ou jusqu’à ce que l’un d’entre eux retourne IDNO ou IDCANCEL.

Les gestionnaires de hook de copie pour les dossiers sont inscrits sous la clé suivante :

HKEY_CLASSES_ROOT/Directory/Shellex/CopyHookHandlers/your_copyhook/{copyhook CLSID value}

Les gestionnaires de crochet de copie pour les imprimantes sont inscrits sous la clé suivante.

HKEY_CLASSES_ROOT/Printers/Shellex/CopyHookHandlers/your_copyhook/{copyhook CLSID value}

Lorsque cette méthode est appelée, l’interpréteur de commande initialise l’interface ICopyHookW directement sans utiliser d’interface IShellExtInit .

Configuration requise

Condition requise	Valeur
En-tête	shlobj.h

Partager via