ChannelErrorType Enumeration
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
An enumeration that contains asynchronous errors sent from the Push Client to the application. These error values can occur regardless of whether the application is running in the foreground or not.
Namespace: Microsoft.Phone.Notification
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)
Syntax
Public Enumeration ChannelErrorType
public enum ChannelErrorType
<object property="enumerationValue" .../>
Members
| Member name | Description | |
|---|---|---|
| ChannelOpenFailed | This error is returned when the Push Client and the Push Notification Service are unable to establish a connection. For more information about push notifications, see Push notifications for Windows Phone 8. | |
| PayloadFormatError | This error is returned when the XML payload format or the HTTP header of the push notification is syntactically invalid. When this error is returned, the HTTP channel is disconnected and the channel must be reopened. | |
| MessageBadContent | This error is returned when the image reference is pointing to an HTTP image, even though the notification channel is not currently bound to a list of URIs. | |
| NotificationRateTooHigh | This error is returned when the Push Client is unable to receive messages because the web service is sending too many messages at too quick a rate to a certain device. | |
| PowerLevelChanged | This error is returned when the Push Client's power policy changes due to a change in battery level. | |
| Unknown | This error is returned when an unknown error occurs. |
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_PUSH_NOTIFICATION |
Windows Phone 8, Windows Phone OS 7.1 |
For more info, see App capabilities and hardware requirements for Windows Phone 8.
Version Information
Windows Phone OS
Supported in: 8.1, 8.0, 7.1, 7.0
Platforms
Windows Phone