OdPrcObjectId::safeOpenObject Method

Syntax

C++

OdPrcObjectPtr safeOpenObject(OpenMode openMode = kForRead, bool openErasedOne = false) const;

Description

Safely opens the database object associated with the identifier.

Parameters

Parameters	Description
openMode	[in] Mode in which the object must be opened.
openErasedOne	[in] Specifies whether erased objects are also opened (true) or not (false).

Returns

Returns a smart pointer to the opened object if successful or throws an exception in other case.

Remarks

openMode must be one of the following:

Identifier	Value	Description
kNotOpen	-1	Object is open for reading.
kForRead	0	Object is open for reading.
kForWrite	1	Object is open for reading and/or writing.
kForNotify	2	Object is open for notifying.

Can throw one of the following exceptions:

Exception	Cause
eNullObjectId	The identifier is null.
ePermanentlyErased	Object was not opened (in case when openErasedOne is true)
eWasErased	Not was not opened (in case when openErasedOne is false)

Links

Relief for ODA Team in Ukraine