IWMDMStorageControl::Move-Methode (mswmdm.h)

Artikel
02/29/2024

Die Move-Methode verschiebt den aktuellen Speicher an einen neuen Speicherort auf dem Gerät.

Syntax

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMStorage  *pTargetObject,
  [in] IWMDMProgress *pProgress
);

Parameter

[in] fuMode

Verarbeitungsmodus, in dem der Move-Vorgang und der Typ der zu vornehmenden Verschiebung aufgerufen werden sollen. 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 mithilfe der Threadmodusverarbeitung ausgeführt. 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 Modustabelle mit einem bitweisen OR kombiniert.

Flag	Beschreibung
WMDM_STORAGECONTROL_INSERTBEFORE	Das Objekt wird vor dem Zielobjekt eingefügt.
WMDM_STORAGECONTROL_INSERTINTO	Das Objekt wird in das Zielobjekt eingefügt.
WMDM_STORAGECONTROL_INSERTAFTER	Das Objekt wird nach dem Zielobjekt eingefügt.

[in] pTargetObject

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

[in] pProgress

Optionaler Zeiger auf eine IWMDMProgress-Schnittstelle , die von der Anwendung implementiert wurde, um den Fortschritt eines laufenden Vorgangs nachzuverfolgen.

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:

Com-Standardfehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Eine Datei oder ein Verzeichnis kann nur innerhalb desselben Stammspeichers verschoben werden.

Wenn das WMDM_MODE_THREAD-Flag angegeben ist, sollten Sie die Status der Vervollständigung erhalten, indem Sie entweder IWMDMProgress2::End2 oder IWMDMProgress3::End3 aufrufen. Diese Methoden stellen sicher, dass der Vorgang abgeschlossen ist, und geben auch ein HRESULT mit Erfolgs- oder Fehlerinformationen zurück.

Wenn eine Anwendung WMDM_MODE_THREAD verwendet und einen pProgress-Parameter ungleich NULL übergibt, muss die Anwendung sicherstellen, dass das Objekt, zu dem pProgress gehört, erst zerstört wird, wenn der Verschiebungsvorgang abgeschlossen ist, da Windows Media Geräte-Manager Statusbenachrichtigungen an dieses Objekt sendet. Dieses Objekt kann erst zerstört werden, nachdem es eine End-Benachrichtigung erhalten hat. Wenn dies nicht geschieht, werden Zugriffsverletzungen verursacht.