Compartilhar via


BackgroundExecutionManager.RequestAccessAsync Método

Definição

Sobrecargas

RequestAccessAsync()

Solicita que o aplicativo tenha permissão para executar tarefas em segundo plano.

RequestAccessAsync(String)

Solicita de forma assíncrona que o aplicativo tenha permissão para executar tarefas em segundo plano.

RequestAccessAsync()

Solicita que o aplicativo tenha permissão para executar tarefas em segundo plano.

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)

Retornos

Quando a operação for concluída, ela retornará um membro da enumeração BackgroundAccessStatus que especifica o resultado.

Atributos

Comentários

VersãoComportamento
Windows 8/Windows 8.1Solicita ao usuário uma caixa de diálogo que solicita que um aplicativo seja adicionado à tela de bloqueio. Deve ser chamado antes de registrar tarefas em segundo plano.
Windows Phone 8,1Não solicita o usuário, mas deve ser chamado antes de registrar as tarefas em segundo plano.
Windows 10Não solicita o usuário, mas deve ser chamado antes de registrar as tarefas em segundo plano. Você não precisa adicionar o aplicativo à tela de bloqueio para usar tarefas em segundo plano no Windows 10, mas ainda precisa chamar esse método para solicitar acesso em segundo plano.

Dica

A partir do Windows 10, não é mais necessário chamar esse método do thread de interface do usuário.

Confira também

Aplica-se a

RequestAccessAsync(String)

Solicita de forma assíncrona que o aplicativo tenha permissão para executar tarefas em segundo plano.

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)

Parâmetros

applicationId
String

Platform::String

winrt::hstring

O PRAID (identificador de aplicativo relativo ao pacote) do aplicativo a ser permitido para executar tarefas em segundo plano. O aplicativo especificado deve estar no mesmo pacote que o aplicativo de chamada. Para obter mais informações sobre o PRAID, consulte o atributo Id do elemento Application .

Se você estiver hospedando tarefas em segundo plano em um servidor COM fora do processo, separado do aplicativo main, passe como o argumento para applicationId o PRAID do aplicativo que define a windows.backgroundTask extensão em seu próprio manifesto de pacote.

Retornos

Uma operação de solicitação assíncrona. Após a conclusão bem-sucedida, contém um membro da enumeração BackgroundAccessStatus que especifica o resultado.

Atributos

Comentários

Versão Comportamento
Windows 8/Windows 8.1 Solicita ao usuário uma caixa de diálogo que solicita que um aplicativo seja adicionado à tela de bloqueio. Deve ser chamado antes de registrar tarefas em segundo plano.
Windows Phone 8,1 Não solicita o usuário, mas deve ser chamado antes de registrar as tarefas em segundo plano.
Windows 10 Não solicita o usuário, mas deve ser chamado antes de registrar as tarefas em segundo plano. Você não precisa adicionar o aplicativo à tela de bloqueio para usar tarefas em segundo plano no Windows 10, mas ainda precisa chamar esse método, ou RequestAccessAsync, para solicitar acesso em segundo plano.

Dica

A partir do Windows 10, não é mais necessário chamar esse método do thread de interface do usuário.

Confira também

Aplica-se a