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

  • Artigo

Declara um conjunto de itens que devem ser copiados para um destino especificado.

Sintaxe

HRESULT CopyItems(
  [in] IUnknown   *punkItems,
  [in] IShellItem *psiDestinationFolder
);

Parâmetros

[in] punkItems

Tipo: IUnknown*

Ponteiro para o IUnknown do objeto IShellItemArray, IDataObject ou IEnumShellItems , que representa o grupo de itens a serem copiados. Você também pode apontar para um objeto IPersistIDList para representar um único item, efetivamente realizando a mesma função que IFileOperation::CopyItem.

[in] psiDestinationFolder

Tipo: IShellItem*

Ponteiro para um IShellItem que especifica a pasta de destino para conter a cópia dos itens.

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 copia os itens, apenas declara os itens a serem copiados. Para copiar um grupo de itens, você deve fazer pelo menos a sequência de chamadas detalhada aqui:

  1. Chame IFileOperation::CopyItems para declarar os itens de origem e a pasta de destino.
  2. Chame IFileOperation::P erformOperations para iniciar a operação de cópia.

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::CopyItem