CardEmulationMode Enumeration
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Describes 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.
Namespace: Microsoft.Phone.SecureElement
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)
Syntax
Public Enumeration CardEmulationMode
public enum CardEmulationMode
<object property="enumerationValue" .../>
Members
| Member name | Description | |
|---|---|---|
| Off | Card emulation mode is turned off by the user. The Secure Element will not be able to communicate with an external NFC terminal. | |
| OnEvenIfWalletIsClosed | Card emulation mode was set by the user such that it may be on even when the wallet application is not running in the foreground. | |
| OnOnlyWhenWalletIsOpened | Card emulation mode was set by the user to only be on when the wallet application is running in the foreground. |
Remarks
Since the external NFC terminal "sees" the phone as a standard NFC card with a Secure Element, this is known as card emulation mode.
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 |
For more info, see App capabilities and hardware requirements for Windows Phone 8.
Version Information
Windows Phone OS
Supported in: 8.1, 8.0