PointCardRW.BeginRemoval Method

Initiates point card removal processing.

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

Usage

'Usage
Dim timeout As Integer
Dim pointCardRW1 As PointCardRW
pointCardRW1.BeginRemoval(timeout)

Syntax

'Declaration
Public MustOverride Sub BeginRemoval( _
    ByVal timeout As Integer _
)

public abstract void BeginRemoval(
    int timeout
);

public: abstract Void BeginRemoval(
    Int32 timeout
);

public abstract void BeginRemoval(
    int timeout
);

public abstract function BeginRemoval(
     timeout : int
) : Void;

Parameters

• timeout
  Gives the number of milliseconds before failing the method. If zero, BeginRemoval tries to begin removal mode, then returns the appropriate status immediately. If WaitForever, BeginRemoval tries to begin removal mode, then waits as long as needed until the point card is ejected or an error occurs.

Remarks

When called, the Point Card Reader/Writer is made ready to eject a point card or activate a print card ejection mode. BeginRemoval is paired with the EndRemoval method for controlling point card removal.

A device with the sensor in the entrance ends normally when a card is ejected from the Point Card Reader/Writer.

A device without the sensor ends normally when ejection processing is implemented.

If the Point Card Reader/Writer cannot be placed into removal or ejection mode, an error is returned to the application. Otherwise, the service object continues to monitor point card removal until either:

• The point card is successfully ejected. In this case, the service object returns a Success status.

  -Or-

• The point card is not ejected before timeout milliseconds have elapsed, or an error is reported by the Point Card Reader/Writer. In this case, the service object either returns Timeout or another error. The Point Card Reader/Writer remains in point card ejection mode. This allows an application to perform some user interaction and reissue the BeginRemoval method without altering the point card handling mechanism.

BeginRemoval returns void if successful, and can throw the following exceptions:

Value	Meaning
Busy	This operation cannot be performed because asynchronous output is in progress.
Illegal	An invalid timeout parameter is specified.
Timeout	The specified time has elapsed without the point card being properly ejected.

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.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows Longhorn, and Windows 2000

Target Platforms

See Also

Reference

PointCardRW Class
PointCardRW Members
Microsoft.PointOfService Namespace
CapCardEntranceSensor
CardState
BeginInsertion
EndInsertion
EndRemoval