PushNotificationChannelManagerForUser.CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync Method

Definition

Overloads

CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer, String)

Creates an object bound to a specified app through which you retrieve a push notification channel from Windows Push Notification Services (WNS). The specified app must be in the same package as the calling app.

CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer, String, String)

Creates an object bound to a specified app through which you retrieve a push notification channel from Windows Push Notification Services (WNS). The specified app must be in the same package as the calling app.

CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer, String)

Creates an object bound to a specified app through which you retrieve a push notification channel from Windows Push Notification Services (WNS). The specified app must be in the same package as the calling app.

public:
 virtual IAsyncOperation<PushNotificationChannel ^> ^ CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer ^ appServerKey, Platform::String ^ channelId) = CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync;
/// [Windows.Foundation.Metadata.Overload("CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PushNotificationChannel> CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer const& appServerKey, winrt::hstring const& channelId);
[Windows.Foundation.Metadata.Overload("CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PushNotificationChannel> CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer appServerKey, string channelId);
function createRawPushNotificationChannelWithAlternateKeyForApplicationAsync(appServerKey, channelId)
Public Function CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync (appServerKey As IBuffer, channelId As String) As IAsyncOperation(Of PushNotificationChannel)

Parameters

appServerKey
IBuffer

An uncompressed key in ANSI X9.62 format. This value is from the P-256 curve defined in the Secure Hash Standard specification.

channelId
String

Platform::String

winrt::hstring

The ID of the push notification channel.

Returns

The object, bound to the app server specified in appServerKey, that is used to request a PushNotificationChannel from WNS.

Attributes

Windows requirements

Device family
Windows 10 Creators Update (introduced in 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v4.0)

Remarks

Note that all raw notifications sent over this channel will have the channelID attached before being delivered to the app. This allows for apps to create multiple channels and differentiate where the notifications come from.

Applies to

CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer, String, String)

Creates an object bound to a specified app through which you retrieve a push notification channel from Windows Push Notification Services (WNS). The specified app must be in the same package as the calling app.

public:
 virtual IAsyncOperation<PushNotificationChannel ^> ^ CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer ^ appServerKey, Platform::String ^ channelId, Platform::String ^ appId) = CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync;
/// [Windows.Foundation.Metadata.Overload("CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsyncWithId")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PushNotificationChannel> CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer const& appServerKey, winrt::hstring const& channelId, winrt::hstring const& appId);
[Windows.Foundation.Metadata.Overload("CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsyncWithId")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PushNotificationChannel> CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync(IBuffer appServerKey, string channelId, string appId);
function createRawPushNotificationChannelWithAlternateKeyForApplicationAsync(appServerKey, channelId, appId)
Public Function CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync (appServerKey As IBuffer, channelId As String, appId As String) As IAsyncOperation(Of PushNotificationChannel)

Parameters

appServerKey
IBuffer

An uncompressed key in ANSI X9.62 format. This value is from the P-256 curve defined in the Secure Hash Standard specification.

channelId
String

Platform::String

winrt::hstring

The ID of the push notification channel.

appId
String

Platform::String

winrt::hstring

The package-relative application identifier (PRAID) of the app to bind to the push notification channel. The specified app must be in the same package as the calling app. For more info on the PRAID, see the Id attribute of the Application element.

If you are hosting background task(s) in an out-of-process COM server, separate from your main application, then pass as the argument for applicationId the PRAID of the application that defines the windows.backgroundTask extension in its own package manifest.

Returns

The object, bound to the app server specified in appServerKey, that is used to request a PushNotificationChannel from WNS.

Attributes

Windows requirements

Device family
Windows 10 Creators Update (introduced in 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v4.0)

Remarks

All raw notifications sent over this channel will have the channelID attached before being delivered to the app. This allows for apps to create multiple channels and differentiate where the notifications come from.

Note

Most applications (including all third party apps) should use the CreateRawPushNotificationChannelWithAlternateKeyForApplicationAsync without the appID parameter.

Applies to