ElectronicValueRW Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Defines the programmatic interface for an Electronic Value Reader/Writer (R/W) device.
public abstract class ElectronicValueRW : Microsoft.PointOfService.PosCommontype ElectronicValueRW = class
inherit PosCommonPublic MustInherit Class ElectronicValueRW
Inherits PosCommon- Inheritance
- Derived
Constructors
| ElectronicValueRW() |
Creates an instance of the ElectronicValueRW class. |
Fields
| ExtendedErrorCenterError |
Indicates that an error was returned from the approval agency. |
| ExtendedErrorCommandError |
Indicates that the command sent to the device is wrong. |
| ExtendedErrorCommunicationError |
Indicates that a communication error has occurred between the approval agency and the device. |
| ExtendedErrorDailyLogOverflow |
Indicates that the transaction log on the device is full. |
| ExtendedErrorDeficient |
Indicates that the amount cannot be subtracted because the balance is insufficient. |
| ExtendedErrorFirmwareBadFile |
Indicates the specified firmware file or files exist, but one or more of those files are either not in the correct format or are corrupted. (Inherited from PosCommon) |
| ExtendedErrorLogOverflow |
Indicates that the transaction log was too large to be stored. |
| ExtendedErrorNoCard | |
| ExtendedErrorOverdeposit |
Indicates that the device cannot add the charge because the maximum charge amount has been exceeded. |
| ExtendedErrorRelease | |
| ExtendedErrorReset |
Indicates that the device was stopped during processing by the device Reset key (Stop key). |
| ExtendedErrorStatistics |
Indicates a specified statistic could not be reset or updated. (Inherited from PosCommon) |
| ExtendedErrorStatisticsDependency | (Inherited from PosCommon) |
| StatisticCommunicationErrorCount |
Holds the programmatic name of the Communication Error Count common statistic. (Inherited from PosCommon) |
| StatisticDeviceCategory |
Holds the programmatic name of the Device Category common statistic. (Inherited from PosCommon) |
| StatisticFirmwareRevision |
Holds the programmatic name of the Firmware Revision common statistic. (Inherited from PosCommon) |
| StatisticHoursPoweredCount |
Holds the programmatic name of the Hours Powered On common statistic. (Inherited from PosCommon) |
| StatisticInstallationDate |
Holds the programmatic name of the Installation Date common statistic. (Inherited from PosCommon) |
| StatisticInterface |
Holds the programmatic name of the Interface common statistic. (Inherited from PosCommon) |
| StatisticManufactureDate |
Holds the programmatic name of the Manufacture Date common statistic. (Inherited from PosCommon) |
| StatisticManufacturerName |
Holds the programmatic name of the Manufacturer Name common statistic. (Inherited from PosCommon) |
| StatisticMechanicalRevision |
Holds the programmatic name of the Mechanical Revision common statistic. (Inherited from PosCommon) |
| StatisticModelName |
Holds the programmatic name of the Model Name common statistic. (Inherited from PosCommon) |
| StatisticSerialNumber |
Holds the programmatic name of the Serial Number common statistic. (Inherited from PosCommon) |
| StatisticUnifiedPOSVersion |
Holds the programmatic name of the Unified POS Version common statistic. (Inherited from PosCommon) |
| StatusCardCaptured |
Indicates that the stock space sensor detects a card in the stock space. |
| StatusCardDetected |
Indicates that the card detection sensor detects a card in the device. |
| StatusCardEntered |
Indicates that the insertion slot sensor detects that a card is remaining in the slot. |
| StatusLogFull |
Indicates that the transaction log is full. |
| StatusLogNearFull |
Indicates that the transaction log is almost full. |
| StatusLogOk |
Indicates that the transaction log has enough capacity. |
| StatusNoCard |
Indicates that the card detection sensor does not detect a card. |
| StatusPowerOff |
Indicates that the device’s power is turned off or it is detached from the terminal. (Inherited from PosCommon) |
| StatusPowerOffline |
Indicates that the device is powered on but is either not ready or unable to respond to requests. (Inherited from PosCommon) |
| StatusPowerOffOffline |
Indicates that either the device’s power is off or it is offline. (Inherited from PosCommon) |
| StatusPowerOnline |
Indicates that the device’s power is turned on and it is ready for use. (Inherited from PosCommon) |
| StatusUpdateFirmwareComplete |
Indicates the update firmware process has completed successfully. (Inherited from PosCommon) |
| StatusUpdateFirmwareCompleteDeviceNotRestored |
Indicates the update firmware process succeeded. However, the Service Object and/or the physical device cannot be returned to the state they were in before the update firmware process started. (Inherited from PosCommon) |
| StatusUpdateFirmwareFailedDeviceNeedsFirmware |
Indicates the update firmware process failed. The device will not be operational until another attempt to update the firmware is successful. (Inherited from PosCommon) |
| StatusUpdateFirmwareFailedDeviceOk |
Indicates the update firmware process failed. However, the device is still operational. (Inherited from PosCommon) |
| StatusUpdateFirmwareFailedDeviceUnknown |
Indicates the update firmware process failed. The device is in an indeterminate state. (Inherited from PosCommon) |
| StatusUpdateFirmwareFailedDeviceUnrecoverable |
Indicates the update firmware process failed. The device is either unusable or unrecoverable through software. (Inherited from PosCommon) |
| StatusUpdateFirmwareProgress |
Indicates the update firmware process has completed 1 to 100 percent successfully. (Inherited from PosCommon) |
| TransitionCenterCheck |
Indicates notification of center check being conducted. |
| TransitionConfirmAutoCharge |
Indicates confirmation of automatic charge. |
| TransitionConfirmCancel |
Indicates confirmation of process cancellation. |
| TransitionConfirmCenterCheck |
Indicates confirmation of a center check. |
| TransitionConfirmCenterCheckComplete |
Indicates the confirmation that a center check has been completed. |
| TransitionConfirmDeviceData | |
| TransitionConfirmInvalidOperation |
Indicates confirmation of invalid operation. |
| TransitionConfirmPinEntryByOuterPinpad |
Indicates confirmation of PIN input request from an external device. |
| TransitionConfirmRemainderSubtraction |
Indicates confirmation of insufficient funds and the deductible amound from the balance. |
| TransitionConfirmSelect |
Indicates confirmation of settlement option when there are options available for settlement. |
| TransitionConfirmTouchRetry |
Indicates confirmation of update retry (continued or canceled). |
| TransitionConfirmTouchTimeout |
Indicates confirmations of timeout to wait for touching. |
| TransitionNotifyBusy |
Indicates status notification that a process is underway. |
| TransitionNotifyCaptureCard |
Indicates notification of card detection. |
| TransitionNotifyCenterCheckComplete |
Indicates that a center check has finished. |
| TransitionNotifyComplete |
Indicates notification of process completion. |
| TransitionNotifyInvalidOperation |
Indicates notification of issuing an invalid operation. |
| TransitionNotifyLock |
Indicates notification that unlocking card or device is required. |
| TransitionNotifyPin |
Indicates notification of available PIN input data in the PIN input status. |
| TransitionNotifyProgress1To100 | |
| TransitionNotifyTouch |
Indicates status notification of waiting for touching. |
| TransitionTouchRetry |
Indicates update retry notification. |
| TransitionTouchRetryCancelable |
Indicates update retry notification (can be canceled). |
| WaitForever |
Used as the value for a timeout parameter in common and device-specific methods to indicate the method should wait until it receives a response, instead of timing out. (Inherited from PosCommon) |
Properties
| AccountNumber | |
| AdditionalSecurityInformation | |
| Amount | |
| ApprovalCode | |
| AsyncMode | |
| AutoDisable | |
| Balance | |
| BalanceOfPoint | |
| CapActivateService | |
| CapAddValue | |
| CapCancelValue | |
| CapCardSensor | |
| CapCompareFirmwareVersion |
Gets a Boolean value that indicates whether the Service Object/device supports comparing the firmware version in the physical device against that of a firmware file. (Inherited from PosCommon) |
| CapDetectionControl | |
| CapElectronicMoney | |
| CapEnumerateCardServices | |
| CapIndirectTransactionLog | |
| CapLockTerminal | |
| CapLogStatus | |
| CapMediumId | |
| CapMembershipCertificate | |
| CapPINDevice | |
| CapPoint | |
| CapPowerReporting |
Gets the power reporting capabilities of the device. (Inherited from PosCommon) |
| CapStatisticsReporting |
Gets a Boolean value that indicates whether the device can accumulate and can provide various statistics regarding usage. (Inherited from PosCommon) |
| CapSubtractValue | |
| CapTrainingMode | |
| CapTransaction | |
| CapTransactionLog | |
| CapUnlockTerminal | |
| CapUpdateFirmware |
Gets a Boolean value that indicates whether the device's firmware can be updated through the UpdateFirmware method. (Inherited from PosCommon) |
| CapUpdateKey | |
| CapUpdateStatistics |
Gets a Boolean value that indicates whether some or all the device statistics can be reset to 0 (zero) by using the ResetStatistic and ResetStatistics methods, or updated by using the UpdateStatistic and UpdateStatistics methods. (Inherited from PosCommon) |
| CapVoucher | |
| CapWriteValue | |
| CardServiceList | |
| CheckHealthText |
Gets a string that indicates the health of the device. (Inherited from PosCommon) |
| Claimed |
Gets a Boolean value that indicates whether the device is claimed for exclusive access. (Inherited from PosCommon) |
| Compatibility | (Inherited from PosDevice) |
| CurrentService | |
| DataCount | |
| DataEventEnabled | |
| DetectionControl | |
| DetectionStatus | |
| DeviceDescription |
Gets a string identifying the device and the company that manufactured it. (Inherited from PosCommon) |
| DeviceEnabled |
Gets or sets a Boolean value that indicates whether the device has been placed in an operational state. (Inherited from PosCommon) |
| DeviceInstanceId | (Inherited from PosCommon) |
| DeviceName |
Gets a short string identifying the device and any pertinent information about it. (Inherited from PosCommon) |
| DevicePath |
Gets or sets the hardware path of a device. (Inherited from PosCommon) |
| ExpirationDate | |
| FreezeEvents |
Gets or sets a Boolean value that indicates whether the application has requested that the Service Object not deliver events. (Inherited from PosCommon) |
| HardwareId | (Inherited from PosCommon) |
| IsExclusiveUseDevice | |
| LastUsedDate | |
| LogStatus | |
| MediumId | |
| OutputId | |
| PINEntry | |
| Point | |
| PowerNotify |
Gets or sets the type of power notification selection made by the application. (Inherited from PosCommon) |
| PowerState |
Gets the current power condition. (Inherited from PosCommon) |
| ReaderWriterServiceList | |
| SequenceNumber | |
| ServiceObjectDescription |
Gets a string identifying the Service Object that supports the device and the company that produced it. (Inherited from PosCommon) |
| ServiceObjectVersion |
Gets the Service Object version number. (Inherited from PosCommon) |
| ServiceType | |
| SettledAmount | |
| SettledPoint | |
| State |
Gets the current state of the device. (Inherited from PosCommon) |
| SynchronizingObject |
Gets or sets the object that is used to marshal the event handler calls issued because of a POS event. (Inherited from PosCommon) |
| TrainingModeState | |
| TransactionLog | |
| VoucherId | |
| VoucherIdList | |
Methods
| AccessData(AccessDataType, Int32, Object) | |
| AccessLog(Int32, TransactionLogType, Int32) |
Gets the transaction log from the device. |
| ActivateEVService(Int32, Object) | |
| ActivateService(Int32, Object) |
Executes the device activation process. |
| AddValue(Int32, Int32) |
Adds Electronic Value on demand to the card as specified by sequenceNumber. |
| BeginDetection(BeginDetectionType, Int32) |
Executes the card detection process. |
| BeginRemoval(Int32) |
Executes the card removal process. |
| CancelValue(Int32, Int32) |
Cancels the Electronic Value related operation specified by SequenceNumber on demand. |
| CaptureCard() |
The card left in the slot is removed. |
| CheckHealth(HealthCheckLevel) |
Tests the state of a device. (Inherited from PosCommon) |
| CheckServiceRegistrationToMedium(Int32, Int32) | |
| Claim(Int32) |
Requests exclusive access to the device. (Inherited from PosCommon) |
| ClearInput() |
Clears all buffered device input. |
| ClearInputProperties() |
Resets the values of properties altered by the DataEvent or ErrorEvent event. |
| ClearOutput() |
Clears all buffered device output. |
| ClearParameterInformation() |
Clears all of the tag valus for the control. |
| Close() |
Releases the device and its resources. (Inherited from PosCommon) |
| CloseDailyEVService(Int32, Object) | |
| CompareFirmwareVersion(String) |
Determines whether the version of the specified firmware is newer than, older than, or the same as the version of firmware in the physical device. (Inherited from PosCommon) |
| DeactivateEVService(Int32, Object) | |
| DeleteConfigurationProperty(String) |
Deletes the specified property from the XML configuration file. (Inherited from PosCommon) |
| DirectIO(Int32, Int32, Object) |
Used to communicate directly with the Service Object. (Inherited from PosCommon) |
| EndDetection() |
Ends the card detection process. |
| EndRemoval() |
Ends the card removal process. |
| EnumerateCardServices() |
Enumerates the services which are used in the card and also sets the CardServiceList property. |
| GetConfigurationProperty(String) |
Used by the Service Object to retrieve the specified property from the XML configuration file. (Inherited from PosCommon) |
| Invoke(Delegate, Object[]) |
Used by the Service Objects to raise an event. (Inherited from PosCommon) |
| LockTerminal() |
Locks the security lock. |
| Open() |
Opens a device for later input/output processing. (Inherited from PosCommon) |
| OpenDailyEVService(Int32, Object) | |
| QueryLastSuccessfulTransactionResult() | |
| ReadValue(Int32, Int32) |
Reads the Electronic Value from the card. |
| RegisterServiceToMedium(Int32, Int32) | |
| Release() |
Releases exclusive access to the device. (Inherited from PosCommon) |
| ResetStatistic(String) |
Resets the specified statistic to 0 (zero). (Inherited from PosCommon) |
| ResetStatistics() |
Resets all statistics associated with a device to 0 (zero). (Inherited from PosCommon) |
| ResetStatistics(StatisticCategories) |
Resets all statistics for a specified category to 0 (zero). (Inherited from PosCommon) |
| ResetStatistics(String[]) |
Resets the specified statistics to 0 (zero). (Inherited from PosCommon) |
| RetrieveResultInformation(String, String) |
Used to associate a tag name with the data value that comes from the card that is being read. |
| RetrieveStatistic(String) |
Retrieves the specified device statistic. (Inherited from PosCommon) |
| RetrieveStatistics() |
Retrieves all device statistics. (Inherited from PosCommon) |
| RetrieveStatistics(StatisticCategories) |
Retrieves the statistics for the specified category. (Inherited from PosCommon) |
| RetrieveStatistics(String[]) |
Retrieves the specified statistics. (Inherited from PosCommon) |
| SetConfigurationProperty(String, String) |
Sets a property value (or create a new property) in the XML configuration file. (Inherited from PosCommon) |
| SetParameterInformation(String, String) |
Used to associate a tag name with additional data value parameters that are associated with the card that is being read. |
| SubtractValue(Int32, Int32) |
Subtracts the Electronic Value from the card. |
| TransactionAccess(TransactionControl) |
Enters or exits transaction mode. |
| UnlockTerminal() |
Releases the security lock. |
| UnregisterServiceToMedium(Int32, Int32) | |
| UpdateData(AccessDataType, Int32, Object) | |
| UpdateFirmware(String) |
Updates the firmware of a device with the version of the firmware contained or defined in the file specified by the firmwareFileName parameter regardless of whether that firmware’s version is newer than, older than, or the same as the version of the firmware already in the device. (Inherited from PosCommon) |
| UpdateKey(Int32, Object) |
Updates the key information in the device. |
| UpdateStatistic(String, Object) |
Updates the value of a specified device statistic. (Inherited from PosCommon) |
| UpdateStatistics(Statistic[]) |
Updates a list of statistics with the corresponding specified values. (Inherited from PosCommon) |
| UpdateStatistics(StatisticCategories, Object) |
Updates the specified category of statistics with the specified value. (Inherited from PosCommon) |
| WriteValue(Int32, Int32) |
Electronic Value is added to the card as specified by SequenceNumber on demand. |
Events
| DataEvent |
Notifies the application about the available input data from the device. |
| DeviceAddedEvent | (Inherited from PosCommon) |
| DeviceRemovedEvent | (Inherited from PosCommon) |
| DirectIOEvent |
Raised by the Service Object to communicate information directly to the application. (Inherited from PosCommon) |
| ErrorEvent |
Notifies the application that an ElectronicValue R/W error has been detected and a suitable response by the application is necessary to process the error condition. |
| OutputCompleteEvent |
Notifies the application that the queued asynchronous output request associated with the OutputId attribute has completed successfully. |
| StatusUpdateEvent |
Raised by the Service Object to alert the application of a device status change. (Inherited from PosCommon) |
| TransitionEvent | |