IMDSPObject::D elete-Methode (mswmdm.h)

Die Delete-Methode entfernt ein Objekt oder Objekte aus einem Speichermedium auf einem Mediengerät.

Syntax

HRESULT Delete(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

Parameter

[in] fuMode

Flag, das vom Client immer auf WMDM_MODE_RECURSIVE festgelegt werden muss. Wenn das Objekt ein Ordner ist, werden es und sein Inhalt sowie alle Unterordner und deren Inhalt gelöscht. Wenn das Objekt eine Datei ist, wird dieser Parameter ignoriert.

[in] pProgress

Zeiger auf eine von der Anwendung implementierte IWMDMProgress-Schnittstelle , die es der Anwendung ermöglicht, Statusbenachrichtigungen für lange Löschvorgänge zu empfangen.

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

Diese Methode entfernt die Objekte dauerhaft aus dem Speichermedium.

Wenn Sie einen CompactFlash-Karte Reader/Writer mit windows Media Geräte-Manager-Dienstanbieter verwenden, schlägt der Aufruf von IMDSPObject::D elete unmittelbar nach IMDSPObject::Write manchmal fehl. Dies liegt daran, dass Daten, die in einen CompactFlash-Reader/Writer geschrieben werden, vom Treiber des Karte Reader/Writer gepuffert werden. Der Dienstanbieter antwortet, als ob die Schreibvorgänge abgeschlossen sind, aber der Treiber schreibt sie nach seinem eigenen Zeitplan auf das Gerät aus. IMDSPObject::D elete schlägt fehl, wenn der Treiber seinen Schreibvorgang nicht abgeschlossen hat.

Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPObject-Schnittstelle

IWMDMProgress-Schnittstelle