| |
| 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 |
|
|
|
| |
| Samples |
| |
|
C++ |
| |
IDossierPtr pDossier = pVenice->CreateDossierContext ("C:\\Venice\\Own", "MyCompanyName");
|
|
|
C# |
| |
Dossier oDossier = oVenice.CreateDossierContext (@"C:\Venice\Own", "MyCompanyName");
|
|
|
VBS |
| |
Dim oDossier
Set oDossier = oVenice.CreateDossierContext("C:\Venice\Own", "MyCompanyName")
|
|
|
VB.NET |
| |
Dim oDossier As ClSdk.Dossier
oDossier = oVenice.CreateDossierContext("C:\Venice\Own", "MyCompanyName")
|
|
