Méthode IWMDMStorageControl ::D elete (mswmdm.h)

Article
03/06/2024

La méthode Delete supprime définitivement ce stockage.

Syntaxe

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

Paramètres

[in] fuMode

Un ou deux des indicateurs suivants, combinés à un OR au niveau du bit. Spécifiez exactement l’un des deux premiers modes ; le troisième mode est facultatif.

Mode	Description
WMDM_MODE_BLOCK	L’opération est effectuée à l’aide du traitement en mode bloc (synchrone). L’appel ne sera pas retourné tant que l’opération n’est pas terminée.
WMDM_MODE_THREAD	L’opération est effectuée à l’aide du traitement en mode thread (asynchrone). L’appel est retourné immédiatement et l’opération est effectuée dans un thread d’arrière-plan.
WMDM_MODE_RECURSIVE	Si l’objet de stockage est un dossier, il et son contenu, et tous les sous-dossiers et leur contenu sont supprimés.

[in] pProgress

Pointeur facultatif vers une interface IWMDMProgress à utiliser par Windows Media Gestionnaire de périphériques pour signaler la progression de l’application.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Si l’indicateur WMDM_MODE_THREAD est spécifié, vous devez obtenir l’achèvement status en appelant IWMDMProgress2 ::End2 ou IWMDMProgress3 ::End3. Ces méthodes garantissent que l’opération est terminée et retournent également un HRESULT avec des informations de réussite ou d’échec.

Lorsque l’opération Supprimer est terminée, toutes les références à l’objet supprimé deviennent non valides. L’application doit libérer ces interfaces et toutes les autres interfaces ou ressources associées à l’objet.

Si une application utilise WMDM_MODE_THREAD et passe un paramètre pProgress non null, l’application doit s’assurer que l’objet auquel appartient pProgress n’est pas détruit tant que l’opération de suppression n’est pas terminée, car Windows Media Gestionnaire de périphériques enverra des notifications de progression à cet objet. Cet objet ne peut être détruit qu’après avoir reçu une notification De fin. Si vous ne le faites pas, vous obtiendrez des violations d’accès.