Cat.AuthorizeVoidPreSales Method

2/27/2008

Preauthorizes a cancellation.

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

Syntax

'Declaration
Public MustOverride Sub AuthorizeVoidPreSales ( _
    sequenceNumber As Integer, _
    amount As Decimal, _
    taxOthers As Decimal, _
    timeout As Integer _
)

public abstract void AuthorizeVoidPreSales (
    int sequenceNumber,
    decimal amount,
    decimal taxOthers,
    int timeout
)

public:
virtual void AuthorizeVoidPreSales (
    int sequenceNumber, 
    Decimal amount, 
    Decimal taxOthers, 
    int timeout
) abstract

public abstract void AuthorizeVoidPreSales (
    int sequenceNumber, 
    Decimal amount, 
    Decimal taxOthers, 
    int timeout
)

public abstract function AuthorizeVoidPreSales (
    sequenceNumber : int, 
    amount : decimal, 
    taxOthers : decimal, 
    timeout : int
)

Parameters

• sequenceNumber
  Sequence number for approval.

• amount
  Purchase amount for approval.

• taxOthers
  Tax and other amounts for approval.

• timeout
  The maximum wait time (in milliseconds) until the response is received from the CAT device. WaitForever, 0, and positive values can be specified.

Remarks

Preauthorization cancellation approval for amount and taxOthers is intended as the approval specified by sequenceNumber.

When timeout is WaitForever, time-out never occurs and the device waits until it receives response from the CAT.

Normal cancellation can be used for CAT service object and CAT devices that have not implemented the preauthorization approval cancellation. Refer to the documentation supplied with the CAT device and/or CAT service object.

AuthorizeVoidPreSales may cause a PosControlException to be thrown with the following ErrorCodes.

Value	Meaning
Illegal	An invalid timeout parameter is specified, or CapAuthorizeVoidPreSales is false.
Timeout	No response was received from CAT during the specified timeout time in milliseconds.
Extended	The detail code is stored in ErrorCodeExtended.
Busy	The CAT device cannot accept any commands now.

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

Cat Class
Cat Members
Microsoft.PointOfService Namespace
CapAuthorizeVoidPreSales