ProcessLauncher.RunToCompletionAsync 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
| RunToCompletionAsync(String, String) |
Inicia um novo processo. Essa função assíncrona é concluída quando o processo iniciado é encerrado. |
| RunToCompletionAsync(String, String, ProcessLauncherOptions) |
Inicia um novo processo, incluindo as opções especificadas. Essa função assíncrona é concluída quando o processo iniciado é encerrado. |
RunToCompletionAsync(String, String)
Inicia um novo processo. Essa função assíncrona é concluída quando o processo iniciado é encerrado.
public:
static IAsyncOperation<ProcessLauncherResult ^> ^ RunToCompletionAsync(Platform::String ^ fileName, Platform::String ^ args);/// [Windows.Foundation.Metadata.Overload("RunToCompletionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<ProcessLauncherResult> RunToCompletionAsync(winrt::hstring const& fileName, winrt::hstring const& args);[Windows.Foundation.Metadata.Overload("RunToCompletionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<ProcessLauncherResult> RunToCompletionAsync(string fileName, string args);function runToCompletionAsync(fileName, args)Public Shared Function RunToCompletionAsync (fileName As String, args As String) As IAsyncOperation(Of ProcessLauncherResult)Parâmetros
- fileName
-
String
Platform::String
winrt::hstring
O nome do processo a ser iniciado.
- args
-
String
Platform::String
winrt::hstring
Argumentos para executar o processo.
Retornos
Quando a operação assíncrona é concluída, ela contém o código de saída do processo iniciado.
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
systemManagement
|
Comentários
Essa API requer o uso da funcionalidade de systemManagement
Para iniciar um processo, o .exe deve estar contido no pacote .appx ou ser registrado na lista de permissões dessa API. Para adicionar um .exe à lista de permissões, modifique HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowedExecutableFilesList e adicione o executável à cadeia de caracteres formatada REG_MULTI_SZ.
Por exemplo:
reg ADD "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher" /f /v AllowedExecutableFilesList /t REG_MULTI_SZ /d "c:\windows\system32\cmd.exe\0"
Confira também
Aplica-se a
RunToCompletionAsync(String, String, ProcessLauncherOptions)
Inicia um novo processo, incluindo as opções especificadas. Essa função assíncrona é concluída quando o processo iniciado é encerrado.
public:
static IAsyncOperation<ProcessLauncherResult ^> ^ RunToCompletionAsync(Platform::String ^ fileName, Platform::String ^ args, ProcessLauncherOptions ^ options);/// [Windows.Foundation.Metadata.Overload("RunToCompletionAsyncWithOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<ProcessLauncherResult> RunToCompletionAsync(winrt::hstring const& fileName, winrt::hstring const& args, ProcessLauncherOptions const& options);[Windows.Foundation.Metadata.Overload("RunToCompletionAsyncWithOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<ProcessLauncherResult> RunToCompletionAsync(string fileName, string args, ProcessLauncherOptions options);function runToCompletionAsync(fileName, args, options)Public Shared Function RunToCompletionAsync (fileName As String, args As String, options As ProcessLauncherOptions) As IAsyncOperation(Of ProcessLauncherResult)Parâmetros
- fileName
-
String
Platform::String
winrt::hstring
Nome do arquivo do processo a ser iniciado.
- args
-
String
Platform::String
winrt::hstring
Argumentos para o processo especificado.
- options
- ProcessLauncherOptions
Opções associadas para executar o processo.
Retornos
Quando a operação assíncrona é concluída, ela contém o código de saída do processo iniciado.
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
systemManagement
|
Comentários
Essa API requer o uso da funcionalidade de systemManagement
Para iniciar um processo, o .exe deve estar contido no pacote .appx ou ser registrado na lista de permissões dessa API. Para adicionar um .exe à lista de permissões, modifique HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowedExecutableFilesList e adicione o executável à cadeia de caracteres formatada REG_MULTI_SZ.
Por exemplo:
reg ADD "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher" /f /v AllowedExecutableFilesList /t REG_MULTI_SZ /d "c:\windows\system32\cmd.exe\0"