Compartilhar via

ProcessLauncher.RunToCompletionAsync Método

  • Referência

Definição

Namespace:
Windows.System

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)

Editar

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

IAsyncOperation<ProcessLauncherResult>

Quando a operação assíncrona é concluída, ela contém o código de saída do processo iniciado.

Atributos
OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo
systemManagement

Comentários

Essa API requer o uso da funcionalidade de systemManagement IoT e a inclusão de de iot na lista IgnorableNamespaces. Os usuários podem adicionar o seguinte àPackage.appmanifest:e adicionar iot à lista existente deIgnorableNamespaces .

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)

Editar

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

IAsyncOperation<ProcessLauncherResult>

Quando a operação assíncrona é concluída, ela contém o código de saída do processo iniciado.

Atributos
OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo
systemManagement

Comentários

Essa API requer o uso da funcionalidade de systemManagement IoT e a inclusão de de iot na lista IgnorableNamespaces. Os usuários podem adicionar o seguinte àPackage.appmanifest:e adicionar iot à lista existente deIgnorableNamespaces .

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