Skip Headers
Oracle® Objects for OLE C++ Class Library Developer's Guide
10g Release 2 (10.2)

Part Number B14308-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

ORef

The ORef interface represents an Oracle REF (reference) as well as a referenceable object (standalone instance).

Remarks

An Oracle REF is an identifier to a referenceable object. Referenceable objects are stored in rows of a object table. By pinning a REF, referenceable objects are fetched to the client side. An ORef implicitly pins the underlying REF when the attributes of a referenceable object is accessed for the first time. The ORef also encapsulates the functionality for object navigational operation utilizing the Complex Object Retrieval Capability (COR).

Attributes of a referenceable object represented by ORef are accessed in the same manner as attributes of an value instance represented by the OObject interface. ORef provides methods for update and delete operations on a referenceable object independent of the context they originated from, such as dynasets, parameters, and so on.

Object level lock should be obtained before modifying the attributes of a referenceable object. This is done though the Edit method of the ORef.

The ORef constructor or Open method creates a new referenceable object in the server and returns information associated with the ORef Object. The Update method inserts a new referenceable object in the server.

Construction and destruction:

ORef

~ORef

operator=

Attributes:


GetEditOption
GetPinOption
GetTableName
IsOpen
operator==
operator!=
IsRefNull
SetEditOption
SetPinOption
Operations:


CancelEdit
Clone
Close
Delete
Edit
GetHexValue(ORef) Method
Open
Refresh
Update