Metodo IFileOperation::MoveItem (shobjidl_core.h)

Dichiara un singolo elemento da spostare in una destinazione specificata.

Sintassi

HRESULT MoveItem(
  [in] IShellItem                 *psiItem,
  [in] IShellItem                 *psiDestinationFolder,
  [in] LPCWSTR                    pszNewName,
  [in] IFileOperationProgressSink *pfopsItem
);

Parametri

[in] psiItem

Tipo: IShellItem*

Puntatore a un oggetto IShellItem che specifica l'elemento di origine.

[in] psiDestinationFolder

Tipo: IShellItem*

Puntatore a un oggetto IShellItem che specifica la cartella di destinazione per contenere l'elemento spostato.

[in] pszNewName

Tipo: LPCWSTR

Puntatore a un nuovo nome per l'elemento nella nuova posizione. Si tratta di una stringa Unicode con terminazione null e può essere NULL. Se NULL, il nome dell'elemento di destinazione è uguale all'origine.

[in] pfopsItem

Tipo: IFileOperationProgressSink*

Puntatore a un oggetto IFileOperationProgressSink da usare per lo stato di avanzamento e le notifiche di errore per questa operazione di spostamento specifica. Se si chiama IFileOperation::Consiglia per l'operazione complessiva, lo stato di avanzamento e le notifiche di errore per l'operazione di spostamento sono incluse, quindi impostare questo parametro su NULL.

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 sposta l'elemento, dichiara semplicemente che l'elemento deve essere spostato. Per spostare un oggetto, è necessario eseguire almeno la sequenza di chiamate dettagliate qui:

1. Chiamare IFileOperation::MoveItem per dichiarare l'elemento di origine, la cartella di destinazione e il nome di destinazione.
2. Chiamare IFileOperation::P erformOperations per avviare l'operazione di spostamento.

Requisiti

Vedi anche

IFileOperation

IFileOperation::MoveItems

PostMoveItem

PreMoveItem