Export (0) Print
Expand All

IFileOperation::MoveItems method

Declares a set of items that are to be moved to a specified destination.

Syntax


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

Parameters

punkItems [in]

Type: IUnknown*

Pointer to the IUnknown of the IShellItemArray, IDataObject, or IEnumShellItems object which represents the group of items to be moved. You can also point to an IPersistIDList object to represent a single item, effectively accomplishing the same function as IFileOperation::MoveItem.

psiDestinationFolder [in]

Type: IShellItem*

Pointer to an IShellItem that specifies the destination folder to contain the moved items.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method does not move the items, it merely declares the items to be moved. To move a group of items, you must make at least the sequence of calls detailed here:

  1. Call IFileOperation::MoveItems to declare the source files or folders and the destination folder.
  2. Call IFileOperation::PerformOperations to begin the move operation.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

See also

IFileOperation
IFileOperation::MoveItem

 

 

Community Additions

ADD
Show:
© 2014 Microsoft