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

Artikel
02/29/2024

Die Delete-Methode löscht diesen Speicher endgültig.

Syntax

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

Parameter

[in] fuMode

Ein oder zwei der folgenden Flags, kombiniert mit einem bitweisen OR. Geben Sie genau einen der ersten beiden Modi an. der dritte Modus ist optional.

Mode	BESCHREIBUNG
WMDM_MODE_BLOCK	Der Vorgang wird mithilfe der (synchronen) Blockmodusverarbeitung ausgeführt. Der Aufruf wird erst zurückgegeben, wenn der Vorgang abgeschlossen ist.
WMDM_MODE_THREAD	Der Vorgang wird mithilfe der (asynchronen) Threadmodusverarbeitung ausgeführt. Der Aufruf wird sofort zurückgegeben, und der Vorgang wird in einem Hintergrundthread ausgeführt.
WMDM_MODE_RECURSIVE	Wenn das Speicherobjekt ein Ordner ist, werden es und sein Inhalt sowie alle Unterordner und deren Inhalt gelöscht.

[in] pProgress

Optionaler Zeiger auf eine IWMDMProgress-Schnittstelle, die von Windows Media Geräte-Manager verwendet werden soll, um den Fortschritt zurück an die Anwendung zu melden.

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

Wenn das WMDM_MODE_THREAD-Flag angegeben ist, sollten Sie den Abschluss status 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 der Delete-Vorgang abgeschlossen ist, werden alle Verweise auf das gelöschte Objekt ungültig. Die Anwendung muss diese Schnittstellen und alle anderen Schnittstellen oder Ressourcen freigeben, die dem Objekt zugeordnet sind.

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 Löschvorgang 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. Andernfalls kommt es zu Zugriffsverletzungen.