CardEmulationMode Enumeration

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)

public enum CardEmulationMode
<object property="enumerationValue" .../>

Member nameDescription
OffCard emulation mode is turned off by the user. The Secure Element will not be able to communicate with an external NFC terminal.
OnEvenIfWalletIsClosedCard emulation mode was set by the user such that it may be on even when the wallet application is not running in the foreground.
OnOnlyWhenWalletIsOpenedCard emulation mode was set by the user to only be on when the wallet application is running in the foreground.

Since the external NFC terminal "sees" the phone as a standard NFC card with a Secure Element, this is known as card emulation mode.


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.


Windows Phone 8

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

Windows Phone OS

Supported in: 8.1, 8.0

© 2017 Microsoft