Compartilhar via

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

  • Artigo

Move o item dentro do volume/namespace, retornando o IShellItem em seu novo local.

Sintaxe

HRESULT MoveItem(
  [in]  IShellItem            *psi,
  [in]  IShellItem            *psiParentDst,
  [in]  LPCWSTR               pszNameDst,
        TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNew
);

Parâmetros

[in] psi

Tipo: IShellItem*

Um ponteiro para o IShellItem a ser movido.

[in] psiParentDst

Tipo: IShellItem*

Um ponteiro para o IShellItem que representa o novo item pai no destino.

[in] pszNameDst

Tipo: LPCWSTR

Ponteiro para um buffer terminado em nulo que contém o caminho de destino.

flags

Tipo: TRANSFER_SOURCE_FLAGS

Sinalizadores que controlam a operação de arquivo. Uma ou mais das constantes TRANSFER_SOURCE_FLAGS .

[out] ppsiNew

Tipo: IShellItem**

Quando esse método retorna com êxito, contém um endereço de um ponteiro para o IShellItem em seu novo local.

Retornar valor

Tipo: HRESULT

Retorna S_OK se a movimentação foi bem-sucedida. Nesse caso, ppsiNew aponta para o endereço do novo item. Outros valores retornados possíveis, códigos de êxito e falha, incluem o seguinte:

Código de retorno Descrição
COPYENGINE_S_USER_IGNORED
 O item de destino já existe e não foi substituído. Nesse caso, ppsiNew é NULL e o chamador deve excluir o item de origem.
COPYENGINE_S_MERGE
 O item de destino já existe e o usuário optou por mesclar as pastas de origem e destino. Nesse caso, ppsiNew aponta para um valor NULL e o chamador deve excluir o item de origem.
E_NOINTERFACE
 Quando o item que está sendo movido é uma pasta, o chamador deve converter uma operação de movimentação em uma operação de cópia e exclusão.
ERROR_NOT_SAME_DEVICE
 O chamador deve converter uma operação de movimentação em uma operação de cópia e exclusão. Esse erro é visto como HRESULT_FROM_WIN32(ERROR_NOT_SAME_DEVICE).
ERROR_FILE_EXISTS
 Ao mover uma pasta, o chamador deve converter a operação de movimentação em uma operação de cópia e exclusão. O item de destino deve dar suporte a ITransferDestination. Esse erro é visto como HRESULT_FROM_WIN32(ERROR_FILE_EXISTS).
ERROR_ALREADY_EXISTS
 Ao mover uma pasta, o chamador deve converter a operação de movimentação em uma operação de cópia e exclusão. O item de destino deve dar suporte a ITransferDestination. Esse erro é visto como HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS).

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)