Venice::CreateDossierContext (Interface: Venice)
 
Creates a new dossier context.
 
IDossier* CreateDossierContext (
    BSTR bsCabinet,
    BSTR bsDossier
)
 
Parameters
bsCabinet
[in] The path of the filing cabinet you want to approach. This path can be absolute, it can be relative to the Venice install directory or it can be blank.
Some examples, assuming that the Venice install directory is 'C:\Venice':
     
Type Input Result
Absolute C:\Venice\Data C:\Venice\Data
  \\Server\Data \\Server\Data
Relative Data C:\Venice\Data
  ExtraLevel\Data C:\Venice\ExtraLevel\Data
  ..\Data C:\Data
  \Data Invalid (C:\Venice\\Data)
Blank   C:\Venice\Data
     
bsDossier
[in] The physical name of the dossier you want to approach.
 
Return value
A pointer to a Dossier object interface.
 
Remarks
How to explicitly destroy this object?
C++
pDossier = NULL
If other objects (pYear, pCustm,...) still refer to this object, assigning the object to NULL has no effect. Otherwise the object is destroyed immediately.
C#
System.Runtime.InteropServices.Marshal.ReleaseComObject(oDossier)
oDossier = null
If other objects (oYear, oCustm,...) still refer to this object, assigning the object to null has no effect. Otherwise the object is released (the reference count is decremented) but not destroyed. The garbage collector decides when the object is actually destroyed. Adding the ReleaseComObject-statement speeds up the actual destruction of the object.
VBS
Set oDossier = Nothing
If other objects (oYear, oCustm,...) still refer to this object, assigning the object to Nothing has no effect. Otherwise the object is destroyed immediately.
VBN
System.Runtime.InteropServices.Marshal.ReleaseComObject(oDossier)
oDossier = Nothing
If other objects (oYear, oCustm,...) still refer to this object, assigning the object to Nothing has no effect. Otherwise the object is released (the reference count is decremented) but not destroyed. The garbage collector decides when the object is actually destroyed. Adding the ReleaseComObject-statement speeds up the actual destruction of the object.
 
See Also
CreateVenice
 
Samples
 
C++
 
IDossierPtr pDossier = pVenice->CreateDossierContext ("C:\\Venice\\Own", "Exact C-Logic");

C#
 
Dossier oDossier = oVenice.CreateDossierContext (@"C:\Venice\Own", "Exact C-Logic");

VBS
 
Dim oDossier
Set oDossier = oVenice.CreateDossierContext("C:\Venice\Own", "Exact C-Logic")

VB.NET
 
Dim oDossier As ClSdk.Dossier
oDossier = oVenice.CreateDossierContext("C:\Venice\Own", "Exact C-Logic")