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 |