Método IFileOperation::MoveItem (shobjidl_core.h)
Declara un único elemento que se va a mover a un destino especificado.
Sintaxis
HRESULT MoveItem(
[in] IShellItem *psiItem,
[in] IShellItem *psiDestinationFolder,
[in] LPCWSTR pszNewName,
[in] IFileOperationProgressSink *pfopsItem
);
Parámetros
[in] psiItem
Tipo: IShellItem*
Puntero a un IShellItem que especifica el elemento de origen.
[in] psiDestinationFolder
Tipo: IShellItem*
Puntero a un IShellItem que especifica la carpeta de destino que va a contener el elemento movido.
[in] pszNewName
Tipo: LPCWSTR
Puntero a un nuevo nombre para el elemento en su nueva ubicación. Se trata de una cadena Unicode terminada en NULL y puede ser NULL. Si es NULL, el nombre del elemento de destino es el mismo que el origen.
[in] pfopsItem
Tipo: IFileOperationProgressSink*
Puntero a un objeto IFileOperationProgressSink que se usará para el estado de progreso y las notificaciones de error para esta operación de movimiento específica. Si llama a IFileOperation::Advise para la operación general, el estado del progreso y las notificaciones de error para la operación de traslado se incluyen allí, por lo que debe establecer este parámetro en NULL.
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
Este método no mueve el elemento, simplemente declara el elemento que se va a mover. Para mover un objeto, debe realizar al menos la secuencia de llamadas que se detallan aquí:
- Llame a IFileOperation::MoveItem para declarar el elemento de origen, la carpeta de destino y el nombre de destino.
- Llame a IFileOperation::P erformOperations para iniciar la operación de movimiento.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |