IMDSPObject::D elete-Methode (mswmdm.h)
Die Delete -Methode entfernt ein Objekt oder Objekte von 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 es sich bei dem Objekt um einen Ordner handelt, werden sie und deren Inhalt sowie alle Unterordner und deren Inhalt gelöscht. Wenn es sich bei dem Objekt um eine Datei handelt, wird dieser Parameter ignoriert.
[in] pProgress
Zeiger auf eine von der Anwendung implementierte IWMDMProgress Schnittstelle, mit der die Anwendung Statusbenachrichtigungen für langwierige Delete-Vorgänge empfangen kann.
Rückgabewert
Die Methode gibt ein HRESULT-zurück. Alle Schnittstellenmethoden in Windows Media Device Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:
- Standard-COM-Fehlercodes
- Windows-Fehlercodes, die in HRESULT-Werte konvertiert wurden
- Windows Media Device Manager –Fehlercodes
Bemerkungen
Mit dieser Methode werden die Objekte dauerhaft aus dem Speichermedium entfernt.
Wenn Sie einen CompactFlash-Kartenleser/Writer mit dem Windows Media Device Manager-Dienstanbieter verwenden, schlägt das Aufrufen IMDSPObject::D elete unmittelbar nach IMDSPObject::Write manchmal fehl. Dies geschieht, weil Daten, die in einen CompactFlash-Reader/Writer geschrieben wurden, vom Treiber des Kartenlesers/Writer gepuffert werden. Der Dienstanbieter antwortet so, als ob die Schreibvorgänge abgeschlossen sind, aber der Treiber schreibt sie entsprechend seinem eigenen Zeitplan auf das Gerät aus. IMDSPObject::D elete schlägt fehl, wenn der Treiber den Schreibvorgang nicht abgeschlossen hat.
Diese Methode muss implementiert werden. Sie darf WMDM_E_NOTSUPPORTED oder E_NOTIMPL nicht zurückgeben. Weitere Informationen finden Sie unter obligatorischen und optionalen Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | mswmdm.h |
| Library | Mssachlp.lib |