Function Get3rdPartyStorage( _
   ByVal StringIn As System.String, _
   ByVal IsStoring As System.Boolean _
) As System.Object

Dim instance As ISwDMDocument19
Dim StringIn As System.String
Dim IsStoring As System.Boolean
Dim value As System.Object
 
value = instance.Get3rdPartyStorage(StringIn, IsStoring)

System.object Get3rdPartyStorage( 
   System.string StringIn,
   System.bool IsStoring
)

System.Object^ Get3rdPartyStorage( 
&   System.String^ StringIn,
&   System.bool IsStoring
) 

Parameters

StringIn

Name of the third-party storage; the name should be less than 30 characters and must be unique and qualified among all of the software parties storing within the current session

IsStoring

True if writing data, false if reading data

Return Value

After calling this method, you must call ISwDMDocument19::Release3rdPartyStorage. Otherwise, the third-party node might remain locked and prevent future access.

NOTE: The name given to the storage stream should be registered so that no conflicts occur. Once registered, the stream name is reserved exclusively for your application.

Passing the unique ID string and a flag to determine if data is being stored or loaded returns an IUnknown pointer. You must then use QueryInterface() to get the Microsoft.VisualStudio.OLE.Interop.IStream interface. The stream object is used for serialization and then released in the third-party code.

SwRootStorage --|

        |-- ThirdPty --|

                |-- <SW Assigned IStream name 1>

                |-- <SW Assigned IStream name 2>

                |-- <SW Assigned IStream name 3>

                ...

                |-- <SW Assigned IStream name n>

The IStream object used by the third party is written under an IStorage object called ThirdPty in the SOLIDWORKS compound document. Each third party writes to a single IStream object whose name is assigned by SOLIDWORKS.

NOTE: If you are using serialization, then be careful with the standard MFC macros. Otherwise, you may get a message like Unexpected File Format after your application is unloaded. One way of using IMPLEMENT_SERIAL:

IMPLEMENT_SERIAL( CCustomAttr, CObject, VERSIONABLE_SCHEMA|0 )