Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODDraft

AcquireStorageUnit

The AcquireStorageUnit method returns a reference to the storage unit with the specified ID.

ODStorageUnit AcquireStorageUnit (in ODStorageUnitID id);

id

The ID of the target storage unit.

return value

A reference to the specified storage-unit object.

DISCUSSION

You call this method to re-create a storage-unit object from its stored data. The id parameter must be the ID of a storage unit in this draft.

This method increments the reference count of the returned storage unit. When you have finished using that storage unit, you should call its Release method.

EXCEPTIONS

kODErrIllegalNullIDInput

The id parameter is null.

SEE ALSO

The ODStorageUnitID type (page 903).
The ODDraft::CreateStorageUnit method (page 170).
The ODStorageUnit class (page 664).
"Creating Additional Storage Units" on page 301 in OpenDoc Programmer's Guide.
Table 11-1 on page 466 in OpenDoc Programmer's Guide.