GetStrongStorageUnitRef
The GetStrongStorageUnitRef method creates a strong persistent reference to the specified storage unit.
void GetStrongStorageUnitRef (
in ODStorageUnitID embeddedSUID,
out ODStorageUnitRef strongRef);
embeddedSUID
- The storage-unit ID of the storage unit whose persistent reference is desired.
strongRef
- A persistent reference to the storage unit specified by the
embeddedSUID parameter.
DISCUSSION
Before you call this method, you should focus this storage unit on the value where you want to store the strong persistent reference. After this method executes successfully, call the SetValue method to store the resulting persistent reference, returned in the strongRef output parameter, into the currently focused value.
- IMPORTANT
- The scope of a persistent reference is limited to the value in which it was created. If you store the persistent reference in a different value, it will almost certainly not refer to the correct storage unit.
EXCEPTIONS
kODErrIllegalNullStorageUnitInput
- The
embeddedSUID parameter is null.
kODErrUnfocusedStorageUnit
- This storage unit is not focused on a value.
kODErrZeroRefCount
- This storage unit has a reference count of 0.
SEE ALSO
The ODStorageUnitID type (page 903).
The ODStorageUnitRef type (page 903).
The ODStorageUnit::GetWeakStorageUnitRef method (page 699).
The ODStorageUnit::IsStrongStorageUnitRef method (page 703).
The ODStorageUnit::SetValue method (page 714).
"Creating Persistent References" on page 281 in OpenDoc Programmer's Guide.
"Persistent References and Cloning" on page 282 in OpenDoc Programmer's Guide.
"Creating Additional Storage Units" on page 301 in OpenDoc Programmer's Guide.
