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[]
)

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

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.

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