Méthode IStorage ::D estroyElement (objidl.h)

  • Article

La méthode DestroyElement supprime le stockage ou le flux spécifié de cet objet de stockage.

Syntaxe

HRESULT DestroyElement(
  [in] const OLECHAR *pwcsName
);

Paramètres

[in] pwcsName

Pointeur vers une chaîne Unicode terminée par un caractère null large qui contient le nom du stockage ou du flux à supprimer.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK L’élément a été supprimé avec succès.
E_PENDING Stockage asynchrone uniquement : une partie ou la totalité des données d’élément n’est actuellement pas disponible.
STG_E_ACCESSDENIED L’appelant ne dispose pas des autorisations nécessaires pour supprimer l’élément.
STG_E_FILENOTFOUND L’élément portant le nom spécifié n’existe pas.
STG_E_INSUFFICIENTMEMORY L’élément n’a pas été supprimé en raison d’un manque de mémoire.
STG_E_INVALIDNAME Valeur non valide pour pwcsName.
STG_E_INVALIDPOINTER Le pointeur spécifié pour l’élément n’était pas valide.
STG_E_INVALIDPARAMETER L’un des paramètres n’était pas valide.
STG_E_REVERTED L’objet de stockage a été invalidé par une opération de rétablissement au-dessus de lui dans l’arborescence des transactions.
STG_E_TOOMANYOPENFILES L’élément n’a pas été supprimé, car il y a trop de fichiers ouverts.

Remarques

La méthode DestroyElement supprime un sous-stockage ou un flux de l’objet de stockage actuel. Après un appel réussi à DestroyElement, toute instance ouverte de l’élément détruit à partir du stockage parent devient non valide.

Si un objet de stockage est ouvert en mode transactionné, la destruction d’un élément nécessite que l’appel à DestroyElement soit suivi d’un appel à IStorage ::Commit.

Note La méthode DestroyElement ne réduit pas le flux de répertoires. Il marque uniquement l’entrée de répertoire supprimé comme non valide. Les entrées non valides sont réutilisées lors de la création d’un nouveau stockage ou d’un flux.

Pour les flux de contenu, les secteurs de flux supprimés sont marqués comme gratuits. Si les secteurs libres se trouvent à la fin du fichier, le fichier de document doit être réduit. Pour compacter un fichier de document, appelez IStorage ::CopyTo sur l’objet de stockage racine et copiez-le vers un nouvel objet de stockage.

 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête objidl.h
Bibliothèque Uuid.lib
DLL Ole32.dll

Voir aussi

IStorage - Implémentation de fichiers composés