Hide Table of Contents
IGetPersistReference3 Method (IModelDocExtension)

Gets the persistent reference ID for the specified object in this model document.

.NET Syntax

Visual Basic (Declaration) 
Function IGetPersistReference3( _
   ByVal DipsObj As System.Object, _
   ByVal Count As System.Integer _
) As System.Byte
Visual Basic (Usage) 
Dim instance As IModelDocExtension
Dim DipsObj As System.Object
Dim Count As System.Integer
Dim value As System.Byte
 
value = instance.IGetPersistReference3(DipsObj, Count)
C# 
System.byte IGetPersistReference3( 
   System.object DipsObj,
   System.int Count
)
C++/CLI 
System.byte IGetPersistReference3( 
&   System.Object^ DipsObj,
&   System.int Count
) 

Parameters

DipsObj
Object  
Count
Size of returned array assigned to that object (see Remarks)

Return Value

Array containing the persistent reference ID assigned to that object

Example

Remarks

Persistent reference ID values obtained using the now obsolete IModelDocExtension::GetPersistReference and its related obsolete methods, IModelDocExtension::GetPersistReferenceCount and IModelDocExtension::GetObjectByPersistReference2, are not compatible with persistent reference IDs obtained using this method and its related methods, IModelDocExtension::GetPersistReferenceCount3 and IModelDocExtension::GetObjectByPersistReference3 or IModelDocExtension::IGetObjectByPersistReference3.

IMPORTANT: SOLIDWORKS recommends not using IModelDocExtension::IGetPersistReference3 with ModelDocExtension::GetPersistReferenceCount3 because when ModelDocExtension::GetPersistReferenceCount3 is used with ModelDocExtension::IGetPersistReference3, you will experience a significant decrease in performance. Instead, use IModelDocExtension::GetPersistReference3.

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.

The internal representations of the return value array may change, possibly from rebuild to rebuild, or more likely, from one release of SOLIDWORKS to the next, but their usage in finding the correct entity will be consistent across rebuilds and SOLIDWORKS releases.

To compare the referenced entities, you could use the Visual Basic Is operator to find out if the entities are the same.

See Persistent Reference IDs for more information.

 

See Also

Availability

SOLIDWORKS 2007 SP3, Revision Number 15.3


Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   IGetPersistReference3 Method (IModelDocExtension)
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:

x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2019 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.