Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODDraft

AcquirePart

The AcquirePart method returns a reference to the part whose data is stored in the specified storage unit.

ODPart AcquirePart (in ODStorageUnitID id);

id

The ID of the target part.

return value

A reference to the specified part object.

DISCUSSION

You call this method to re-create a part object from its stored data.

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

EXCEPTIONS

kODErrIllegalNullIDInput

The id parameter is null.

SEE ALSO

The ODStorageUnitID type (page 903).
The ODDraft::CreatePart method (page 169).
The ODPart class (page 459).
"The InitPartFromStorage Method" on page 295 in OpenDoc Programmer's Guide.
"Adding an Embedded Part" on page 305 in OpenDoc Programmer's Guide.
"Embedding a Single Part" on page 347 in OpenDoc Programmer's Guide.
Table 11-1 on page 466 in OpenDoc Programmer's Guide.