ClaimedMagneticStripeReader 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.
Represents the claimed magnetic stripe reader.
public ref class ClaimedMagneticStripeReader sealed : IClosable/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ClaimedMagneticStripeReader final : IClosable/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ClaimedMagneticStripeReader final : IClosable[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ClaimedMagneticStripeReader : System.IDisposable[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ClaimedMagneticStripeReader : System.IDisposablePublic NotInheritable Class ClaimedMagneticStripeReader
Implements IDisposable- Inheritance
- Attributes
- Implements
Windows requirements
| Device family |
Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v1.0)
|
Remarks
This object is created when ClaimReaderAsync method completes.
Version history
| Windows version | SDK version | Value added |
|---|---|---|
| 1809 | 17763 | Closed |
Properties
| DataEncryptionAlgorithm |
Gets or sets the MagneticStripeReaderEncryptionAlgorithms that will be used to encrypt the track data. |
| DeviceId |
Gets the DeviceInformation.Id of the claimed magnetic stripe reader. |
| IsDecodeDataEnabled |
Indicates whether to provide raw or decoded data from the most recently swiped card. |
| IsDeviceAuthenticated |
Indicates whether the device is authenticated. |
| IsDisabledOnDataReceived |
Gets or sets a Boolean value that indicates whether the magnetic stripe reader is disabled after receiving the data from the most recently swiped card. |
| IsEnabled |
Indicates whether the magnetic stripe reader is ready to receive data events. |
| IsTransmitSentinelsEnabled |
Indicates whether the track data contains start and end sentinel values. |
| TracksToRead |
Gets or sets the track data that the application wants to receive following a card swipe. |
Methods
| AuthenticateDeviceAsync(Byte[]) |
Puts the device into an authenticated state. |
| Close() |
Releases the exclusive claim to the magnetic strip reader. |
| DeAuthenticateDeviceAsync(Byte[]) |
Puts the device into an unauthenticated state. |
| DisableAsync() |
Puts the ClaimedMagneticStripeReader into a state where it cannot receive data events. |
| Dispose() |
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. |
| EnableAsync() |
Gets the magnetic stripe reader into a ready state to receive data events. |
| ResetStatisticsAsync(IIterable<String>) |
Resets the specified statistics to zero for all statistics that can be reset. |
| RetainDevice() |
Retains exclusive claim to the magnetic stripe reader. |
| RetrieveDeviceAuthenticationDataAsync() |
Retrieves a challenge token from the device. |
| SetErrorReportingType(MagneticStripeReaderErrorReportingType) |
Sets the type of error to report by the ErrorOccurred event. |
| UpdateKeyAsync(String, String) |
Provides a new encryption key to the device. |
| UpdateStatisticsAsync(IIterable<KeyValuePair<String,String>>) |
Updates the specified statistics. |
Events
| AamvaCardDataReceived |
Occurs when a motor vehicle card is swiped. |
| BankCardDataReceived |
Occurs when a bank card is swiped. |
| Closed |
Event that is raised when the ClaimedMagneticStripeReader is closed. |
| ErrorOccurred |
Occurs when the magnetic stripe reader detects an error when reading a card. |
| ReleaseDeviceRequested |
Occurs when the device gets a request to release its exclusive claim. |
| VendorSpecificDataReceived |
Occurs when a vendor-specific card is swiped. |