Share via


CashChanger.DispenseCash Method

2/27/2008

Dispenses the specified cash units and cash counts from the device.

Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)

Syntax

'Declaration
Public MustOverride Sub DispenseCash ( _
    cashCounts As CashCount() _
)
public abstract void DispenseCash (
    CashCount[] cashCounts
)
public:
virtual void DispenseCash (
    array<CashCount>^ cashCounts
) abstract
public abstract void DispenseCash (
    CashCount[] cashCounts
)
public abstract function DispenseCash (
    cashCounts : CashCount[]
)

Parameters

  • cashCounts
    Contains the dispensing cash units and counts, as an array of CashCount objects.

Remarks

Dispenses the cash from the cash changer into the exit specified by CurrentExit. The cash dispensed is specified by pairs of cash units and counts.

DispenseCash is performed synchronously if AsyncMode is false, and asynchronously if AsyncMode is true.

DispenseCash can throw general exceptions and PosControlExceptions with the following values in ErrorCode:

Value

Meaning

Busy

The specified cash cannot be dispensed because an asynchronous method is in progress.

Illegal

One of the following errors occurred:

  • The cashCounts parameter value is illegal for the current exit.

  • Cash cannot be dispensed because cash acceptance is in progress.

Extended

An extended error has occurred.

The following value may be set in ErrorCodeExtended if P:Microsoft.PointOfService.PosControlException.ErrorCode is Extended:

Value

Meaning

ExtendedErrorOverDispense

The specified cash cannot be dispensed because of a cash shortage.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also

Reference

CashChanger Class
CashChanger Members
Microsoft.PointOfService Namespace
CashCount
AsyncMode
CurrentExit