Public Shared Function Reserve( _
   ByVal feature As Feature, _
   ByVal count As Integer _
) As String

Dim feature As Feature
Dim count As Integer
Dim value As String
 
value = CartridgeManager.Reserve(feature, count)

public static string Reserve( 
   Feature feature,
   int count
)

public:
static String^ Reserve( 
   Feature feature,
   int count
) 

Parameters

feature

Feature to reserve.

count

Number of cartridges to reserve.

Return Value

If there are not enough cartridges to reserve for the operation, this method throws DjVuException with its ErrorCode set to 32 (errCartridgeNotEnough).

Normally, all the methods provided in the SDK internally consumes cartridges and you don't have to access the cartridges. The following code is provided for informative purpose.

// Consumes 10 cartridges of Feature11
string ticket = CartridgeManager.Reserve(Feature.Feature11, 10);
try
{
    // TODO: actual job here
    // ...

    // OK, everything worked fine; commit the reservation.
    CartridgeManager.Commit(ticket);
}
catch
{
    // the job above failed (throws some exception),
    // we should revert the reservation.
    CartridgeManager.Revert(ticket);
    throw;
}

Target Platforms: Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

Reference

CartridgeManager Class
CartridgeManager Members
Commit Method
Revert Method
Cuminas License System