Interface ICopyHookW (shlobj.h)

Expõe um método que cria um manipulador de gancho de cópia. Um manipulador de gancho de cópia é uma extensão shell que determina se uma pasta shell ou objeto de impressora pode ser movido, copiado, renomeado ou excluído. O Shell chama o método ICopyHookW::CopyCallback antes de executar uma dessas operações.

Herança

A interface ICopyHookW herda da interface IUnknown.

Métodos

A interface ICopyHookW tem esses métodos.

ICopyHookW::CopyCallback Determina se o Shell terá permissão para mover, copiar, excluir ou renomear um objeto de pasta ou impressora. (Unicode)

Comentários

O manipulador de gancho de cópia, que é um servidor em processo OLE (uma dll), não executa a tarefa em si, mas aprova ou desaprova a ação. Se o Shell receber aprovação do manipulador de gancho de cópia, ele executará a operação do sistema de arquivos. Os manipuladores de gancho de cópia não são informados sobre o sucesso de uma operação, portanto, eles não podem monitorar ações executadas em objetos de pasta, a menos que FindFirstChangeNotification seja usado.

Um objeto folder pode ter vários manipuladores de gancho de cópia. Por exemplo, mesmo que o Shell já tenha um manipulador de gancho de cópia registrado para um objeto de pasta específico, você ainda poderá registrar um dos seus. Se dois ou mais manipuladores de gancho de cópia forem registrados para um objeto, o Shell simplesmente chamará cada um deles antes de executar uma das operações do sistema de arquivos especificadas.

O Shell inicializa ICopyHookA diretamente, sem usar a interface IShellExtInit primeiro.

CopyCallback retorna um valor int que indica se o Shell deve executar a operação. O Shell chamará cada manipulador de gancho de cópia registrado para um objeto de pasta até que todos os manipuladores tenham sido chamados ou até que um deles tenha retornado um valor diferente de IDYES. O manipulador retorna IDYES para especificar que a operação deve ser executada ou IDNO ou IDCANCEL para especificar que a operação deve ser descontinuada.

Implemente um manipulador de gancho de cópia quando quiser ser capaz de controlar quando, ou se, essas operações do sistema de arquivos são executadas em um determinado objeto. Talvez você queira usar um manipulador de gancho de cópia em pastas compartilhadas, por exemplo.

Você não chama essa extensão do Shell diretamente. CopyCallback é chamado pelo Shell antes de mover, copiar, excluir ou renomear um objeto de pasta shell.

Observação

O cabeçalho shlobj.h define ICopyHook como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cabeçalho	shlobj.h