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

Artigo
03/05/2024

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)

Share via