BackgroundExecutionManager.RequestAccessAsync Método

Definição

Namespace:

Windows.ApplicationModel.Background

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

IAsyncOperation<BackgroundAccessStatus>

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

Atributos

OverloadAttribute RemoteAsyncAttribute

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 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

• RequestAccessAsync(String)

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

IAsyncOperation<BackgroundAccessStatus>

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

OverloadAttribute RemoteAsyncAttribute

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

• RequestAccessAsync