Método IFileOperation::MoveItem (shobjidl_core.h)

Declara um único item que deve ser movido para um destino especificado.

Sintaxe

HRESULT MoveItem(
  [in] IShellItem                 *psiItem,
  [in] IShellItem                 *psiDestinationFolder,
  [in] LPCWSTR                    pszNewName,
  [in] IFileOperationProgressSink *pfopsItem
);

Parâmetros

[in] psiItem

Tipo: IShellItem*

Ponteiro para um IShellItem que especifica o item de origem.

[in] psiDestinationFolder

Tipo: IShellItem*

Ponteiro para um IShellItem que especifica a pasta de destino para conter o item movido.

[in] pszNewName

Tipo: LPCWSTR

Ponteiro para um novo nome para o item em seu novo local. Essa é uma cadeia de caracteres Unicode terminada em nulo e pode ser NULL. Se FOR NULL, o nome do item de destino será o mesmo que a origem.

[in] pfopsItem

Tipo: IFileOperationProgressSink*

Ponteiro para um objeto IFileOperationProgressSink a ser usado para status de progresso e notificações de erro para essa operação de movimentação específica. Se você chamar IFileOperation::Advise para a operação geral, as status de progresso e as notificações de erro para a operação de movimentação serão incluídas lá, portanto, defina esse parâmetro como NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método não move o item, apenas declara o item a ser movido. Para mover um objeto, você deve fazer pelo menos a sequência de chamadas detalhada aqui:

1. Chame IFileOperation::MoveItem para declarar o item de origem, a pasta de destino e o nome do destino.
2. Chame IFileOperation::P erformOperations para iniciar a operação de movimentação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

Ifileoperation

IFileOperation::MoveItems

PostMoveItem

PreMoveItem