Método IStorageProviderCopyHook::CopyCallback

Determina si el Shell podrá mover, copiar, eliminar o cambiar el nombre de una carpeta en la raíz de sincronización de un proveedor de nube.

Sintaxis

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

Parámetros

hwnd [in]

Identificador de la ventana que el controlador de enlace de copia debe usar como elemento primario para cualquier elemento de la interfaz de usuario que el controlador necesite mostrar. Si FOF_SILENT se especifica en la operación, el método debe omitir este parámetro.

operación [in]

Operación que se va a realizar. Este parámetro puede ser uno de los valores enumerados en el miembro wFunc de la estructura SHFILEOPSTRUCT .

flags [in]

Marcas que controlan la operación. Este parámetro puede ser uno o varios de los valores enumerados en el miembro fFlags de la estructura SHFILEOPSTRUCT .

Para los enlaces de copia de impresora, este valor es uno de los siguientes valores definidos en shellapi.h.

Valor	Descripción
PO_DELETE	Se está eliminando una impresora. El parámetro srcFile apunta a la ruta de acceso completa a la impresora especificada.
PO_RENAME	Se cambia el nombre de una impresora. El parámetro srcFile apunta al nuevo nombre de la impresora. El parámetro destFile apunta al nombre anterior.
PO_PORTCHANGE	No compatible. No debe usarse.
PO_REN_PORT	No compatible. No debe usarse.

srcFile [in]

Puntero a una cadena que contiene el nombre de la carpeta de origen.

srcAttribs [in]

Atributos de la carpeta de origen. Este parámetro puede ser una combinación de cualquiera de las marcas de atributo de archivo (FILE_ATTRIBUTE_*) definidas en los archivos de encabezado. Consulte Constantes de atributo de archivo.

destFile [in]

Puntero a una cadena que contiene el nombre de la carpeta de destino.

destAttribs [in]

Atributos de la carpeta de destino. Este parámetro puede ser una combinación de cualquiera de las marcas de atributo de archivo (FILE_ATTRIBUTE_*) definidas en los archivos de encabezado. Consulte Constantes de atributo de archivo.

result [out]

Valor entero que indica si el Shell debe realizar la operación. Uno de los siguientes:

Valor	Descripción
IDYES	Permite la operación.
IDNO	Impide la operación en esta carpeta, pero continúa con cualquier otra operación que se haya aprobado (por ejemplo, una operación de copia por lotes).
IDCANCEL	Impide la operación actual y cancela las operaciones pendientes.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente o un código de error de lo contrario.

Comentarios

El Shell llama al controlador de enlace de copia del proveedor de nube para cada carpeta bajo la raíz de sincronización registrada. Para registrar un controlador de enlace de copia para carpetas en la nube, establezca el valor copyHook en la clave HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Explorer/SyncRootManager/{SyncRootId} en el CLSID del objeto de enlace de copia.

Cuando se llama al método CopyCallback , shell inicializa la interfaz IStorageProviderCopyHook directamente sin usar primero una interfaz IShellExtInit .

Requisitos

Requisito	Value
Cliente mínimo compatible	compilación 19624 de Windows 10 Insider Preview
Encabezado	shobjidl.h

Consulte también

Crear un motor de sincronización en la nube que admita archivos de marcador de posición