BackgroundExecutionManager.RequestAccessAsync Méthode

Définition

Espace de noms:

Windows.ApplicationModel.Background

Surcharges

RequestAccessAsync()	Demande que l’application soit autorisée à exécuter des tâches en arrière-plan.
RequestAccessAsync(String)	Demande de manière asynchrone que l’application soit autorisée à exécuter des tâches en arrière-plan.

RequestAccessAsync()

Demande que l’application soit autorisée à exécuter des tâches en arrière-plan.

public:
 static IAsyncOperation<BackgroundAccessStatus> ^ RequestAccessAsync();

/// [Windows.Foundation.Metadata.Overload("RequestAccessAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync();

[Windows.Foundation.Metadata.Overload("RequestAccessAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync();

function requestAccessAsync()

Public Shared Function RequestAccessAsync () As IAsyncOperation(Of BackgroundAccessStatus)

Retours

IAsyncOperation<BackgroundAccessStatus>

Une fois l’opération terminée, elle retourne un membre de l’énumération BackgroundAccessStatus qui spécifie le résultat.

Attributs

OverloadAttribute RemoteAsyncAttribute

Remarques

Version	Comportement
Windows 8 et Windows 8.1	Invite l’utilisateur avec une boîte de dialogue qui demande qu’une application soit ajoutée à l’écran de verrouillage. Doit être appelé avant d’inscrire des tâches en arrière-plan.
Windows Phone 8.1	N’invite pas l’utilisateur, mais doit être appelé avant d’inscrire des tâches en arrière-plan.
Windows 10	N’invite pas l’utilisateur, mais doit être appelé avant d’inscrire des tâches en arrière-plan. Vous n’avez pas besoin d’ajouter l’application à l’écran de verrouillage pour utiliser des tâches en arrière-plan dans Windows 10, mais vous devez toujours appeler cette méthode pour demander l’accès en arrière-plan.

Conseil

À compter de Windows 10, il n’est plus nécessaire d’appeler cette méthode à partir du thread d’interface utilisateur.

Voir aussi

• RequestAccessAsync(String)

RequestAccessAsync(String)

Demande de manière asynchrone que l’application soit autorisée à exécuter des tâches en arrière-plan.

public:
 static IAsyncOperation<BackgroundAccessStatus> ^ RequestAccessAsync(Platform::String ^ applicationId);

/// [Windows.Foundation.Metadata.Overload("RequestAccessForApplicationAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync(winrt::hstring const& applicationId);

[Windows.Foundation.Metadata.Overload("RequestAccessForApplicationAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync(string applicationId);

function requestAccessAsync(applicationId)

Public Shared Function RequestAccessAsync (applicationId As String) As IAsyncOperation(Of BackgroundAccessStatus)

Paramètres

applicationId

String

Platform::String

winrt::hstring

Identificateur d’application relatif au package (PRAID) de l’application à autoriser à exécuter des tâches en arrière-plan. L’application spécifiée doit se trouver dans le même package que l’application appelante. Pour plus d’informations sur le PRAID, consultez l’attribut ID de l’élément Application .

Si vous hébergez des tâches en arrière-plan sur un serveur COM hors processus, distinct de votre application main, passez comme argument du applicationId PRAID de l’application qui définit l’extension windows.backgroundTask dans son propre manifeste de package.

Retours

IAsyncOperation<BackgroundAccessStatus>

Opération de requête asynchrone. Une fois la saisie terminée, contient un membre de l’énumération BackgroundAccessStatus qui spécifie le résultat.

Attributs

OverloadAttribute RemoteAsyncAttribute

Remarques

Version	Comportement
Windows 8 et Windows 8.1	Invite l’utilisateur avec une boîte de dialogue qui demande qu’une application soit ajoutée à l’écran de verrouillage. Doit être appelé avant d’inscrire des tâches en arrière-plan.
Windows Phone 8.1	N’invite pas l’utilisateur, mais doit être appelé avant d’inscrire des tâches en arrière-plan.
Windows 10	N’invite pas l’utilisateur, mais doit être appelé avant d’inscrire des tâches en arrière-plan. Vous n’avez pas besoin d’ajouter l’application à l’écran de verrouillage pour utiliser des tâches en arrière-plan dans Windows 10, mais vous devez toujours appeler cette méthode, ou RequestAccessAsync, pour demander l’accès en arrière-plan.

Conseil

À compter de Windows 10, il n’est plus nécessaire d’appeler cette méthode à partir du thread d’interface utilisateur.

Voir aussi

• RequestAccessAsync