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

Artigo
03/02/2024

Recicle o item para o local de reciclagem fornecido e retorne o item em seu novo local.

Sintaxe

HRESULT RecycleItem(
  [in]  IShellItem            *psiSource,
  [in]  IShellItem            *psiParentDest,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

Parâmetros

[in] psiSource

Tipo: IShellItem*

Um ponteiro para o IShellItem a ser reciclado.

[in] psiParentDest

Tipo: IShellItem*

Um ponteiro para o IShellItem do local de reciclagem (o novo pai do item).

[in] flags

Tipo: TRANSFER_SOURCE_FLAGS

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

[out] ppsiNewDest

Tipo: IShellItem**

Quando o método retorna, contém o endereço de um ponteiro para o IShellItem reciclado.

Retornar valor

Tipo: HRESULT

Retorna um dos seguintes ou um código de erro.

Código de retorno	Descrição
COPYENGINE_S_YES	O usuário respondeu "Sim" à caixa de diálogo.
COPYENGINE_S_USER_RETRY	O usuário respondeu para repetir a ação atual.
COPYENGINE_S_USER_IGNORED	O usuário respondeu "Não" à caixa de diálogo.
COPYENGINE_S_DONT_PROCESS_CHILDREN	Os itens filhos não devem ser processados.
COPYENGINE_S_PENDING	O erro foi enfileirado e será exibido posteriormente.
COPYENGINE_E_USER_CANCELLED	O usuário cancelou a ação atual.
COPYENGINE_E_REQUIRES_ELEVATION	A operação requer privilégios elevados.

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