IStorage::DestroyElement - OLE Programmer's Reference (ole.hlp)

IStorage::DestroyElement

Removes the specified element from this storage object.

HRESULT DestroyElement(

const wchar_t * pwcsName	//Points to the name of the element to be removed
);

Parameter
pwcsName

[in]Points to the name of the element to be removed from this storage object.

Return Values
S_OK

The element was successfully removed.

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 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.

Comments
An existing open instance of this element from the parent becomes invalid after the IStorage::DestroyElement call completes.

The removal is subject to committing the changes if the storage object is opened in transacted mode.

More Online Helps