Metodo IFileOperation::SetOperationFlags (shobjidl_core.h)

Imposta i parametri per l'operazione corrente.

Sintassi

HRESULT SetOperationFlags(
  [in] DWORD dwOperationFlags
);

Parametri

[in] dwOperationFlags

Tipo: DWORD

Flag che controllano l'operazione file. Questo membro può essere una combinazione dei flag seguenti. I flag FOF sono definiti in Shellapi.h e i flag FOFX sono definiti in Shobjidl.h.

FOF_ALLOWUNDO (0x0040)

Conservare le informazioni di annullamento, se possibile.

Prima di Windows Vista, le operazioni potrebbero essere annullate solo dallo stesso processo che ha eseguito l'operazione originale.

Nei sistemi Windows Vista e versioni successive l'ambito dell'annullamento è una sessione utente. Qualsiasi processo in esecuzione nella sessione utente può annullare un'altra operazione. Lo stato di annullamento viene mantenuto nel processo di Explorer.exe e, purché tale processo sia in esecuzione, può coordinare le funzioni di annullamento.

Se il parametro del file di origine non contiene nomi di file e percorsi completi, questo flag viene ignorato.

FOF_FILESONLY (0x0080)

Eseguire l'operazione solo sui file (non nelle cartelle) se viene specificato un nome di file con caratteri jolly (.).

FOF_NOCONFIRMATION (0x0010)

Rispondere con Sì a Tutti per qualsiasi finestra di dialogo visualizzata.

FOF_NOCONFIRMMKDIR (0x0200)

Non confermare la creazione di una nuova cartella se è necessario crearne uno.

FOF_NO_CONNECTED_ELEMENTS (0x2000)

Non spostare gli elementi connessi come gruppo. Spostare solo i file specificati.

FOF_NOCOPYSECURITYATTRIBS (0x0800)

Non copiare gli attributi di sicurezza dell'elemento.

FOF_NOERRORUI (0x0400)

Non visualizzare un messaggio all'utente se si verifica un errore. Se questo flag viene impostato senza FOFX_EARLYFAILURE, qualsiasi errore viene considerato come se l'utente avesse scelto Ignora o Continua in una finestra di dialogo. Interrompe l'azione corrente, imposta un flag per indicare che un'azione è stata interrotta e procede con il resto dell'operazione.

FOF_NORECURSION (0x1000)

Funziona solo nella cartella locale. Non operare in modo ricorsivo in sottodirectory.

FOF_RENAMEONCOLLISION (0x0008)

Assegnare all'elemento un nuovo nome in un'operazione di spostamento, copia o ridenominazione se esiste già un elemento con il nome di destinazione.

FOF_SILENT (0x0004)

Non visualizzare una finestra di dialogo di stato.

FOF_WANTNUKEWARNING (0x4000)

Inviare un avviso se un file o una cartella viene eliminato definitivamente durante un'operazione di eliminazione anziché riciclato. Questo flag sostituisce parzialmente FOF_NOCONFIRMATION.

FOFX_ADDUNDORECORD (0x20000000)

Introdotto in Windows 8. L'operazione file è stata richiamata dall'utente e deve essere inserita nello stack di annullamento. Questo flag è preferibile FOF_ALLOWUNDO.

FOFX_NOSKIPJUNCTIONS (0x00010000)

Passare alle giunzioni dello spazio dei nomi shell. Per impostazione predefinita, le giunzioni non vengono immesse. Per altre informazioni sulle giunzioni, vedere Specifica della posizione di un'estensione dello spazio dei nomi.

FOFX_PREFERHARDLINK (0x00020000)

Se possibile, creare un collegamento rigido anziché una nuova istanza del file nella destinazione.

FOFX_SHOWELEVATIONPROMPT (0x00040000)

Se un'operazione richiede diritti elevati e il flag di FOF_NOERRORUI è impostato per disabilitare l'interfaccia utente di errore, visualizzare comunque un prompt dell'interfaccia utente di Controllo dell'account utente.

FOFX_EARLYFAILURE (0x00100000)

Se FOFX_EARLYFAILURE viene impostato insieme a FOF_NOERRORUI, l'intero set di operazioni viene arrestato in caso di errore in qualsiasi operazione. Questo flag è valido solo quando è impostato FOF_NOERRORUI.

FOFX_PRESERVEFILEEXTENSIONS (0x00200000)

Rinominare i conflitti in modo da mantenere le estensioni di file. Questo flag è valido solo quando è impostato anche FOF_RENAMEONCOLLISION.

FOFX_KEEPNEWERFILE (0x00400000)

Mantenere il file o la cartella più recente, in base alla proprietà Data modificata, se si verifica un conflitto. Questa operazione viene eseguita automaticamente senza l'interfaccia utente di richiesta presentata all'utente.

FOFX_NOCOPYHOOKS (0x00800000)

Non usare hook di copia.

FOFX_NOMINIMIZEBOX (0x01000000)

Non consentire la riduzione al minimo della finestra di dialogo di stato.

FOFX_MOVEACLSACROSSVOLUMES (0x02000000)

Copiare gli attributi di sicurezza dell'elemento di origine nell'elemento di destinazione quando si esegue un'operazione di spostamento tra volumi. Senza questo flag, l'elemento di destinazione riceve gli attributi di sicurezza della nuova cartella.

FOFX_DONTDISPLAYSOURCEPATH (0x04000000)

Non visualizzare il percorso dell'elemento di origine nella finestra di dialogo di stato.

FOFX_DONTDISPLAYDESTPATH (0x08000000)

Non visualizzare il percorso dell'elemento di destinazione nella finestra di dialogo di stato.

FOFX_RECYCLEONDELETE (0x00080000)

Introdotto in Windows 8. Quando un file viene eliminato, inviarlo al Cestino anziché eliminarlo definitivamente.

FOFX_REQUIREELEVATION (0x10000000)

Introdotta in Windows Vista SP1. L'utente prevede un requisito di elevazione dei diritti, pertanto non visualizzare una finestra di dialogo che richiede una conferma dell'elevazione.

FOFX_COPYASDOWNLOAD (0x40000000)

Introdotta in Windows 7. Visualizzare un oggetto Download anziché Copia del messaggio nella finestra di dialogo di stato.

FOFX_DONTDISPLAYLOCATIONS (0x80000000)

Introdotta in Windows 7. Non visualizzare la riga di posizione nella finestra di dialogo di stato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Impostare questi flag prima di chiamare IFileOperation::P erformOperations per definire i parametri per le operazioni eseguite, ad esempio copia, eliminazione o ridenominazione.

Requisiti