Interfaccia ICopyHookA (shlobj.h)

Espone un metodo che crea un gestore hook di copia . Un gestore hook di copia è un'estensione shell che determina se una cartella shell o un oggetto stampante può essere spostato, copiato, rinominato o eliminato. Shell chiama il metodo ICopyHookA::CopyCallback prima di eseguire una di queste operazioni.

Eredità

L'interfaccia ICopyHookA eredita dall'interfaccia IUnknown.

Metodi

L'interfaccia ICopyHookA include questi metodi.

Osservazioni

Il gestore hook di copia, ovvero un server ole in-process (dll), non esegue l'attività stessa, ma approva o non approva l'azione. Se shell riceve l'approvazione dal gestore hook di copia, esegue l'operazione del file system. I gestori hook di copia non vengono informati sull'esito positivo di un'operazione, pertanto non possono monitorare le azioni eseguite sugli oggetti cartella a meno che non venga usato FindFirstChangeNotification.

Un oggetto cartella può avere più gestori hook di copia. Ad esempio, anche se shell dispone già di un gestore hook di copia registrato per un oggetto cartella specifico, è comunque possibile registrarne uno personalizzato. Se due o più gestori hook di copia vengono registrati per un oggetto, shell li chiama semplicemente prima di eseguire una delle operazioni del file system specificate.

Shell inizializza direttamente ICopyHookA, senza usare prima l'interfaccia IShellExtInit .

CopyCallback restituisce un valore int che indica se shell deve eseguire l'operazione. La shell chiamerà ogni gestore hook di copia registrato per un oggetto cartella fino a quando non vengono chiamati tutti i gestori o fino a quando uno di essi non ha restituito un valore diverso da IDYES. Il gestore restituisce IDYES per specificare che l'operazione deve essere eseguita oppure IDNO o IDCANCEL per specificare che l'operazione deve essere sospesa.

Implementare un gestore hook di copia quando si vuole essere in grado di controllare quando o se queste operazioni del file system vengono eseguite su un determinato oggetto. È possibile usare un gestore hook di copia nelle cartelle condivise, ad esempio.

Non chiamare direttamente questa estensione shell. CopyCallback viene chiamato dalla shell prima di spostare, copiare, eliminare o rinominare un oggetto cartella shell.

Fabbisogno