Function IGetObjectByPersistReference3( _
   ByVal Count As Integer, _
   ByRef PersistId As Byte, _
   ByRef ErrorCode As Integer _
) As Object

Dim instance As IModelDocExtension
Dim Count As Integer
Dim PersistId As Byte
Dim ErrorCode As Integer
Dim value As Object
 
value = instance.IGetObjectByPersistReference3(Count, PersistId, ErrorCode)

object IGetObjectByPersistReference3( 
   int Count,
   ref byte PersistId,
   out int ErrorCode
)

Object^ IGetObjectByPersistReference3( 
&   int Count,
&   byte% PersistId,
&   [Out] int ErrorCode
) 

Parameters

Count

Size of persistent reference ID (see Remarks)

PersistId

Object's persistent reference ID (see Remarks)

ErrorCode

Success or error code as defined by swPersistReferencedObjectStates_e (see Remarks)

Return Value

A persistent reference ID is related to a model. It is portable and can be saved within the model or in other places. Some persistent reference IDs are general to all models and can be instantiated from all models. Your application must handle persistent reference IDs and their relationships among models.

Before calling this method:

1. Call IModelDocExtension::GetPersistentReferenceCount3 to determine the size of the persistent reference ID.
2. Call IModelDocExtension::IGetPersistReference3 to get the object's persistent reference ID.

The swPersistReferencedObject_Suppressed and swPersistReferencedObject_Deleted enumerators only apply to references of topological entities.

IModelDocExtension::GetObjectByPersistReference3 was designed to return the base class of a feature to take advantage of the base feature class functionality. Objects returned by IModelDocExtension::GetObjectByPersistReference3 are often features, including IConfiguration, IRefPlane, and IRefAxis objects. You must first obtain a reference to a feature, and then use IFeature::GetSpecificFeature2 to get the original object.

See Persistent Reference IDs for more information.