Metodo IStorageProviderCopyHook::CopyCallback

Articolo
06/13/2023

Determina se la shell potrà spostare, copiare, eliminare o rinominare una cartella nella radice di sincronizzazione di un provider di servizi cloud.

Sintassi

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

Parametri

hwnd [in]: Handle per la finestra che il gestore dell'hook di copia deve usare come elemento padre per qualsiasi elemento dell'interfaccia utente che il gestore potrebbe dover visualizzare. Se FOF_SILENT viene specificato nell'operazione, il metodo deve ignorare questo parametro.

operazione [in]: Operazione da eseguire. Questo parametro può essere uno dei valori elencati nel membro wFunc della struttura SHFILEOPSTRUCT .

flag [in]

Flag che controllano l'operazione. Questo parametro può essere uno o più dei valori elencati nel membro fFlags della struttura SHFILEOPSTRUCT .

Per gli hook di copia della stampante, questo valore è uno dei valori seguenti definiti in shellapi.h.

Valore	Descrizione
PO_DELETE	Viene eliminata una stampante. Il parametro srcFile punta al percorso completo della stampante specificata.
PO_RENAME	Viene rinominata una stampante. Il parametro srcFile punta al nuovo nome della stampante. Il parametro destFile punta al nome precedente.
PO_PORTCHANGE	Non supportato. Non usare.
PO_REN_PORT	Non supportato. Non usare.

srcFile [in]: Puntatore a una stringa contenente il nome della cartella di origine.

srcAttribs [in]

Attributi della cartella di origine. Questo parametro può essere una combinazione di qualsiasi flag di attributo file (FILE_ATTRIBUTE_*) definito nei file di intestazione. Vedere Costanti degli attributi di file.

destFile [in]

Puntatore a una stringa contenente il nome della cartella di destinazione.

destAttribs [in]

Attributi della cartella di destinazione. Questo parametro può essere una combinazione di qualsiasi flag di attributo file (FILE_ATTRIBUTE_*) definito nei file di intestazione. Vedere Costanti degli attributi di file.

result [out]

Valore intero che indica se shell deve eseguire l'operazione. I tipi validi sono:

Valore	Descrizione
IDYES	Consente l'operazione.
IDNO	Impedisce l'operazione in questa cartella, ma continua con qualsiasi altra operazione approvata, ad esempio un'operazione di copia batch.
IDCANCEL	Impedisce l'operazione corrente e annulla tutte le operazioni in sospeso.

Valore restituito

Restituisce S_OK in caso di esito positivo o un codice di errore in caso contrario.

Commenti

Shell chiama il gestore hook di copia del provider di servizi cloud per ogni cartella nella radice di sincronizzazione registrata. Per registrare un gestore hook di copia per le cartelle cloud, impostare il valore CopyHook nel HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Explorer/SyncRootManager/{SyncRootId} sulla chiave CLSID dell'oggetto hook di copia.

Quando viene chiamato il metodo CopyCallback , Shell inizializza l'interfaccia IStorageProviderCopyHook direttamente senza usare prima un'interfaccia IShellExtInit .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Insider Preview Build 19624
Intestazione	shobjidl.h

Vedi anche

Creare un motore di sincronizzazione cloud che supporti i file segnaposto

Condividi tramite