Método IFileOperation::SetOperationFlags (shobjidl_core.h)
Establece parámetros para la operación actual.
Sintaxis
HRESULT SetOperationFlags(
[in] DWORD dwOperationFlags
);
Parámetros
[in] dwOperationFlags
Tipo: DWORD
Marcas que controlan la operación de archivo. Este miembro puede ser una combinación de las marcas siguientes. Las marcas FOF se definen en Shellapi.h y las marcas FOFX se definen en Shobjidl.h.
FOF_ALLOWUNDO (0x0040)
Conservar la información de deshacer, si es posible.
Antes de Windows Vista, las operaciones solo se podían deshacer del mismo proceso que realizó la operación original.
En Windows Vista y sistemas posteriores, el ámbito de la deshacer es una sesión de usuario. Cualquier proceso que se ejecute en la sesión de usuario puede deshacer otra operación. El estado de deshacer se mantiene en el proceso de Explorer.exe y, siempre que se ejecute ese proceso, puede coordinar las funciones de deshacer.
Si el parámetro de archivo de origen no contiene nombres de archivo y ruta de acceso completos, se omite esta marca.
FOF_FILESONLY (0x0080)
Realice la operación solo en archivos (no en carpetas) si se especifica un nombre de archivo comodín (.).
FOF_NOCONFIRMATION (0x0010)
Responda con Sí a Todo para cualquier cuadro de diálogo que se muestre.
FOF_NOCONFIRMMKDIR (0x0200)
No confirme la creación de una nueva carpeta si la operación requiere que se cree una.
FOF_NO_CONNECTED_ELEMENTS (0x2000)
No mueva elementos conectados como grupo. Mueva solo los archivos especificados.
FOF_NOCOPYSECURITYATTRIBS (0x0800)
No copie los atributos de seguridad del elemento.
FOF_NOERRORUI (0x0400)
No muestre un mensaje al usuario si se produce un error. Si esta marca se establece sin FOFX_EARLYFAILURE, cualquier error se trata como si el usuario hubiera elegido Omitir o Continuar en un cuadro de diálogo. Detiene la acción actual, establece una marca para indicar que se anuló una acción y continúa con el resto de la operación.
FOF_NORECURSION (0x1000)
Solo funcionan en la carpeta local. No funcione recursivamente en subdirectorios.
FOF_RENAMEONCOLLISION (0x0008)
Asigne un nuevo nombre al elemento en una operación de movimiento, copia o cambio de nombre si ya existe un elemento con el nombre de destino.
FOF_SILENT (0x0004)
No mostrar un cuadro de diálogo de progreso.
FOF_WANTNUKEWARNING (0x4000)
Envíe una advertencia si se destruye un archivo o una carpeta durante una operación de eliminación en lugar de reciclarse. Esta marca invalida parcialmente FOF_NOCONFIRMATION.
FOFX_ADDUNDORECORD (0x20000000)
Introducido en Windows 8. La operación de archivo se invocó por el usuario y debe colocarse en la pila de deshacer. Se prefiere esta marca para FOF_ALLOWUNDO.
FOFX_NOSKIPJUNCTIONS (0x00010000)
Entre las uniones del espacio de nombres de Shell. De forma predeterminada, no se introducen uniones. Para obtener más información sobre las uniones, vea Especificar la ubicación de una extensión de espacio de nombres.
FOFX_PREFERHARDLINK (0x00020000)
Si es posible, cree un vínculo físico en lugar de una nueva instancia del archivo en el destino.
FOFX_SHOWELEVATIONPROMPT (0x00040000)
Si una operación requiere derechos elevados y la marca de FOF_NOERRORUI está establecida para deshabilitar la interfaz de usuario de error, muestre sin embargo un símbolo del sistema de interfaz de usuario de UAC.
FOFX_EARLYFAILURE (0x00100000)
Si FOFX_EARLYFAILURE se establece junto con FOF_NOERRORUI, se detiene todo el conjunto de operaciones al encontrar cualquier error en cualquier operación. Esta marca solo es válida cuando se establece FOF_NOERRORUI.
FOFX_PRESERVEFILEEXTENSIONS (0x00200000)
Cambie el nombre de las colisiones de forma que conserve las extensiones de nombre de archivo. Esta marca solo es válida cuando también se establece FOF_RENAMEONCOLLISION.
FOFX_KEEPNEWERFILE (0x00400000)
Mantenga el archivo o carpeta más reciente, en función de la propiedad Fecha de modificación, si se produce una colisión. Esto se hace automáticamente sin ninguna interfaz de usuario de aviso presentada al usuario.
FOFX_NOCOPYHOOKS (0x00800000)
No use enlaces de copia.
FOFX_NOMINIMIZEBOX (0x01000000)
No permita que el cuadro de diálogo de progreso se minimice.
FOFX_MOVEACLSACROSSVOLUMES (0x02000000)
Copie los atributos de seguridad del elemento de origen en el elemento de destino al realizar una operación de movimiento entre volúmenes. Sin esta marca, el elemento de destino recibe los atributos de seguridad de su nueva carpeta.
FOFX_DONTDISPLAYSOURCEPATH (0x04000000)
No muestre la ruta de acceso del elemento de origen en el cuadro de diálogo de progreso.
FOFX_DONTDISPLAYDESTPATH (0x08000000)
No muestre la ruta de acceso del elemento de destino en el cuadro de diálogo de progreso.
FOFX_RECYCLEONDELETE (0x00080000)
Introducido en Windows 8. Cuando se elimina un archivo, envíelo a la Papelera de reciclaje en lugar de eliminarlo permanentemente.
FOFX_REQUIREELEVATION (0x10000000)
Introducido en Windows Vista SP1. El usuario espera un requisito para la elevación de derechos, por lo que no muestra un cuadro de diálogo que solicita una confirmación de la elevación.
FOFX_COPYASDOWNLOAD (0x40000000)
Introducido en Windows 7. Muestra una descarga en lugar de copiar un mensaje en el cuadro de diálogo de progreso.
FOFX_DONTDISPLAYLOCATIONS (0x80000000)
Introducido en Windows 7. No muestre la línea de ubicación en el cuadro de diálogo de progreso.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Establezca estas marcas antes de llamar a IFileOperation::P erformOperations para definir los parámetros de las operaciones que se están realizando, como copiar, eliminar o cambiar el nombre.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |