Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODDraft

RemoveStorageUnit

The RemoveStorageUnit method removes the specified storage unit from this draft.

void RemoveStorageUnit (in ODStorageUnit storageUnit);

storageUnit

A reference to the storage-unit object to be removed.

DISCUSSION

OpenDoc calls this method internally; parts, the document shell, and container applications do not call this method.

When this method is called, the reference count of the specified storage unit must be 1, and this draft's current permissions must provide write access.

If this method executes successfully, it marks this draft as dirty. The specified storage unit is no longer a valid object, and this draft no longer contains a storage-unit object with the corresponding ID.

EXCEPTIONS

kODErrIllegalOperationOnSU

The specified storage unit cannot be removed. For example, this draft cannot remove the storage unit where it stores its draft properties.

kODErrInvalidStorageUnit

The specified storage unit is not a valid storage unit.

SEE ALSO

The ODDraft::AcquireStorageUnit method (page 158).
The ODDraft::CreateStorageUnit method (page 170).
The ODStorageUnit::Remove method (page 707).
The ODStorageUnit class (page 664).