SecureElementReader Class

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Represents an object that can interact with the Secure Element on the phone.

Inheritance Hierarchy

System..::.Object
  Microsoft.Phone.SecureElement..::.SecureElementReader

Namespace:  Microsoft.Phone.SecureElement
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)

Syntax

Public Class SecureElementReader _
    Implements IDisposable
public class SecureElementReader : IDisposable

The SecureElementReader type exposes the following members.

Properties

  Name Description
CardEmulationMode Gets the user's selection in the wallet settings regarding the ability of the Secure Element to communicate with an external NFC terminal via the wireless NFC radio link.
IsSecureElementPresent Gets a value indicating whether a Secure Element is present.
TsmRoutingId Gets an ID that identifies the Trusted Service Manager (TSM) that manages this Secure Element.

Top

Methods

  Name Description
Dispose Releases all resources used by the current instance of SecureElementReader.
Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Finalize Frees resources used by the SecureElementReader object. (Overrides Object..::.Finalize()()().)
GetDefault Gets the default SecureElementReader object.
GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
GetType Gets the Type of the current instance. (Inherited from Object.)
MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
OpenSession Connects to the Secure Element.
RegisterSecureElementItemAsync Registers an ISecureElementItem with the Secure Element.
ToString Returns a string that represents the current object. (Inherited from Object.)

Top

Events

  Name Description
RegisterSecureElementItemCompleted Occurs when registration with the Secure Element is complete.

Top

Remarks

Capabilities

If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.

ID_CAP_WALLET

Windows Phone 8

ID_CAP_WALLET_SECUREELEMENT

Windows Phone 8

For more info, see App capabilities and hardware requirements for Windows Phone 8.

Important Note:

To deploy an app that uses the ID_CAP_WALLET_SECUREELEMENT capability, you must request special permissions and have that permission applied to your developer account. For more info and assistance, contact Developer support.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0

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

Microsoft.Phone.SecureElement Namespace