Metodo IFileOperation::MoveItem (shobjidl_core.h)

Articolo
03/15/2023

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:

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

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

PostMoveItem

PreMoveItem

Condividi tramite