Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODStorageUnit

SetStorageUnitRef

The SetStorageUnitRef method creates in the currently focused value a persistent reference to the specified storage unit using the specified the persistent identifier.

void SetStorageUnitRef (in ODStorageUnitID embeddedSUID,
                        in ODStorageUnitRef ref);

embeddedSUID

The storage-unit ID for the storage unit to be referenced.

ref

The persistent identifier for the new persistent reference being created.

DISCUSSION

This method is called only by the container suite. Parts, the document shell, and container applications should not call this method.

The embeddedSUID parameter specifies the ID that identifies the storage unit within the current session; the ref parameter specifies the reference to be used within the currently focused value to identify the storage unit persistently across sessions.

EXCEPTIONS

kODErrIllegalNullIDInput

The embeddedSUID parameter is null.

kODErrUnfocusedStorageUnit

This storage unit is not focused on a value.

SEE ALSO

The ODStorageUnitID type (page 903).
The ODStorageUnitRef type (page 903).