Compartilhar via


Método IStorageProviderCopyHook::CopyCallback

Determina se o Shell terá permissão para mover, copiar, excluir ou renomear uma pasta na raiz de sincronização de um provedor de nuvem.

Sintaxe

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

Parâmetros

hwnd [in]

Um identificador para a janela que o manipulador de gancho de cópia deve usar como pai para qualquer elemento de interface do usuário que o manipulador possa precisar exibir. Se FOF_SILENT for especificado na operação, o método deverá ignorar esse parâmetro.

operação [in]

A operação a ser executada. Esse parâmetro pode ser um dos valores listados no membro wFunc da estrutura SHFILEOPSTRUCT .

sinalizadores [in]

Os sinalizadores que controlam a operação. Esse parâmetro pode ser um ou mais dos valores listados no membro fFlags da estrutura SHFILEOPSTRUCT .

Para ganchos de cópia de impressora, esse valor é um dos seguintes valores definidos em shellapi.h.

Valor Descrição
PO_DELETE Uma impressora está sendo excluída. O parâmetro srcFile aponta para o caminho completo para a impressora especificada.
PO_RENAME Uma impressora está sendo renomeada. O parâmetro srcFile aponta para o novo nome da impressora. O parâmetro destFile aponta para o nome antigo.
PO_PORTCHANGE Sem suporte. Não use.
PO_REN_PORT Sem suporte. Não use.

srcFile [in]

Um ponteiro para uma cadeia de caracteres que contém o nome da pasta de origem.

srcAttribs [in]

Os atributos da pasta de origem. Esse parâmetro pode ser uma combinação de qualquer um dos sinalizadores de atributo de arquivo (FILE_ATTRIBUTE_*) definidos nos arquivos de cabeçalho. Consulte Constantes de atributo de arquivo.

destFile [in]

Um ponteiro para uma cadeia de caracteres que contém o nome da pasta de destino.

destAttribs [in]

Os atributos da pasta de destino. Esse parâmetro pode ser uma combinação de qualquer um dos sinalizadores de atributo de arquivo (FILE_ATTRIBUTE_*) definidos nos arquivos de cabeçalho. Consulte Constantes de atributo de arquivo.

resultado [out]

O valor inteiro que indica se o Shell deve executar a operação. Um dos seguintes:

Valor Descrição
IDYES Permite a operação.
IDNO Impede a operação nessa pasta, mas continua com quaisquer outras operações que tenham sido aprovadas (por exemplo, uma operação de cópia em lote).
IDCANCEL Impede a operação atual e cancela todas as operações pendentes.

Valor retornado

Retorna S_OK se tiver êxito ou um código de erro de outra forma.

Comentários

O Shell chama o manipulador de gancho de cópia do provedor de nuvem para cada pasta na raiz de sincronização registrada. Para registrar um manipulador de gancho de cópia para pastas de nuvem, defina o valor copyHook na chave HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Explorer/SyncRootManager/{SyncRootId} para o CLSID do objeto de gancho de cópia.

Quando o método CopyCallback é chamado, o Shell inicializa a interface IStorageProviderCopyHook diretamente sem usar uma interface IShellExtInit primeiro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 Insider Preview Build 19624
Cabeçalho shobjidl.h

Confira também

Criar um Mecanismo de Sincronização de Nuvem que dê suporte a arquivos de espaço reservado