Metodo IFileOperation::CopyItems (shobjidl_core.h)

Dichiara un set di elementi da copiare in una destinazione specificata.

Sintassi

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

Parametri

[in] punkItems

Tipo: IUnknown*

Puntatore all'oggetto IUnknown dell'oggetto IShellItemArray, IDataObject o IEnumShellItems che rappresenta il gruppo di elementi da copiare. È anche possibile puntare a un oggetto IPersistIDList per rappresentare un singolo elemento, completando in modo efficace la stessa funzione di IFileOperation::CopyItem.

[in] psiDestinationFolder

Tipo: IShellItem*

Puntatore a un oggetto IShellItem che specifica la cartella di destinazione per contenere la copia degli elementi.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo non copia gli elementi, dichiara semplicemente gli elementi da copiare. Per copiare un gruppo di elementi, è necessario eseguire almeno la sequenza di chiamate dettagliate qui:

1. Chiamare IFileOperation::CopyItems per dichiarare gli elementi di origine e la cartella di destinazione.
2. Chiamare IFileOperation::P erformOperations per avviare l'operazione di copia.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

IFileOperation

IFileOperation::CopyItem