IStorage::DestroyElement
Removes the specified storage or stream from this storage object.
HRESULT DestroyElement(
wchar * pwcsName //Points to the name of the element to be removed
);
Parameter
-
pwcsName
-
[in] Points to a wide character string that contains the name of the storage or stream to be removed.
Return Values
-
S_OK
-
The element was successfully removed.
-
E_PENDING
-
Asynchronous Storage only: Part or all of the element's data is currently unavailable. For more information see IFillLockBytes and Asynchronous Storage.
-
STG_E_ACCESSDENIED
-
The caller does not have sufficient permissions for removing the element.
-
STG_E_FILENOTFOUND
-
The element with the specified name does not exist.
-
STG_E_INSUFFICIENTMEMORY
-
The element was not removed due to a lack of memory.
-
STG_E_INVALIDNAME
-
Invalid value for pwcsName.
-
STG_E_INVALIDPOINTER
-
The pointer specified for the element was invalid.
-
STG_E_INVALIDPARAMETER
-
One of the parameters was invalid.
-
STG_E_REVERTED
-
The storage object has been invalidated by a revert operation above it in the transaction tree.
-
STG_E_TOOMANYOPENFILES
-
The element was not removed because there are too many open files.
Remarks
The DestroyElement method deletes a substorage or stream from the current storage object. After a successful call to DestroyElement, any open instance of the destroyed element from the parent storage becomes invalid.
If a storage object is opened in transacted mode, destruction of an element requires that the call to DestroyElement be followed by a call to IStorage::Commit.
QuickInfo
Windows NT: Use version 3.1 or later.
Windows: Use Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in objidl.h.
See Also
IStorage - Compound File Implementation