IMDSPObject::Move-Methode (mswmdm.h)

Artikel
03/13/2024

Die Move-Methode verschiebt eine Datei oder einen Ordner auf einem Mediengerät.

Syntax

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress,
  [in] IMDSPStorage  *pTarget
);

Parameter

[in] fuMode

Verarbeitungsmodus, in dem der Move-Vorgang und die Methode aufgerufen werden, mit der verschoben werden soll. Geben Sie genau einen der folgenden beiden Modi an. Wenn beide Modi angegeben sind, wird der Blockmodus verwendet.

Mode	BESCHREIBUNG
WMDM_MODE_BLOCK	Der Vorgang wird mithilfe der Blockmodusverarbeitung ausgeführt. Der Aufruf wird erst zurückgegeben, wenn der Vorgang abgeschlossen ist.
WMDM_MODE_THREAD	Der Vorgang wird im Threadmodus verarbeitet. Der Aufruf wird sofort zurückgegeben, und der Vorgang wird in einem Hintergrundthread ausgeführt.

In der folgenden Tabelle sind Flags aufgeführt, die angeben, wohin das Objekt verschoben wird. Ein Wert aus dieser Tabelle wird mit einem Wert aus der vorherigen Mode-Tabelle kombiniert, indem ein bitweises OR verwendet wird.

Methode der Verschiebung	BESCHREIBUNG
WMDM_STORAGECONTROL_INSERTBEFORE	Das Objekt wird vor dem Zielobjekt eingefügt.
WMDM_STORAGECONTROL_INSERTINTO	Das Objekt wird in das Zielobjekt eingefügt. Das Zielobjekt muss ein Ordner sein. Wenn das Zielobjekt eine Datei ist, schlägt diese Methode fehl.
WMDM_STORAGECONTROL_INSERTAFTER	Das -Objekt wird nach dem Zielobjekt eingefügt.

[in] pProgress

Zeiger auf eine IWMDMProgress-Schnittstelle , die von der Anwendung implementiert wurde, um den Fortschritt laufender Vorgänge nachzuverfolgen. Dieser Parameter ist optional und sollte auf NULL festgelegt werden, wenn er nicht verwendet wird.

[in] pTarget

Zeiger auf das Zielobjekt vor oder nach dem Sie das aktuelle Objekt platzieren möchten.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Standard-COM-Fehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Eine Datei oder ein Verzeichnis kann nur innerhalb desselben Stammspeichers verschoben werden. Das Objekt, für das diese Methode aufgerufen wird, muss aktualisiert werden, um seinen neuen Speicherort widerzuspiegeln.

Diese Methode ist optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.