PushNotificationManager.CreateChannelAsync(Guid) Methode

Definition

Fordert asynchron einen Pushkanal vom Windows-Pushbenachrichtigungsdienst (WNS) an.

Hinweis

Die PushNotificationManager-Klasse ist vom Singleton-Paket abhängig. Aufgrund dieser Abhängigkeit sind bestimmte Überlegungen zu beachten, wenn Sie diese APIs aus einer eigenständigen App aufrufen. Weitere Informationen und Einzelheiten finden Sie unter Abhängigkeiten von zusätzlichen MSIX-Paketen.

public:
 virtual IAsyncOperationWithProgress<PushNotificationCreateChannelResult ^, PushNotificationCreateChannelStatus> ^ CreateChannelAsync(Platform::Guid remoteId) = CreateChannelAsync;
IAsyncOperationWithProgress<PushNotificationCreateChannelResult, PushNotificationCreateChannelStatus> CreateChannelAsync(winrt::guid const& remoteId);
public IAsyncOperationWithProgress<PushNotificationCreateChannelResult,PushNotificationCreateChannelStatus> CreateChannelAsync(Guid remoteId);
function createChannelAsync(remoteId)
Public Function CreateChannelAsync (remoteId As Guid) As IAsyncOperationWithProgress(Of PushNotificationCreateChannelResult, PushNotificationCreateChannelStatus)

Parameter

remoteId
Guid

Platform::Guid

winrt::guid

Der Remotebezeichner für den erstellten Pushkanal. Dieser Wert, der als Azure AppId bezeichnet wird, ist eine GUID, die mit der in Azure Active Directory (AAD) angegebenen Anwendungs-ID übereinstimmt. Informationen zum Abrufen Ihrer Anwendungs-ID finden Sie unter Verwenden des Portals zum Erstellen einer Azure AD-Anwendung und eines Dienstprinzipals, die auf Ressourcen zugreifen können.

Gibt zurück

Eine asynchrone Aktion mit Status, die bei Abschluss ein PushNotificationCreateChannelResult zurückgibt.

Hinweise

In den meisten Fällen sollten Kanalerstellungsanforderungen in wenigen Sekunden abgeschlossen sein. Da es sich um einen Netzwerkvorgang handelt, können Kanalanforderungsvorgänge anfänglich fehlschlagen, wodurch die in der Plattform integrierte Wiederholungslogik ausgelöst wird. In diesen Fällen können Kanalanforderungsvorgänge zwischen 2 und 16 Minuten dauern.

Gilt für: