Méthode IStorage ::D estroyElement (objidl.h)
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.
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour