BackgroundExecutionManager.RequestAccessAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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ã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
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.