Compartir a través de


ProcessLauncher.RunToCompletionAsync Método

Definición

Sobrecargas

RunToCompletionAsync(String, String)

Inicia un nuevo proceso. Esta función asincrónica se completa cuando finaliza el proceso iniciado.

RunToCompletionAsync(String, String, ProcessLauncherOptions)

Inicia un nuevo proceso, incluidas las opciones especificadas. Esta función asincrónica se completa cuando finaliza el proceso iniciado.

RunToCompletionAsync(String, String)

Inicia un nuevo proceso. Esta función asincrónica se completa cuando finaliza el proceso iniciado.

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

Nombre del proceso que se va a iniciar.

args
String

Platform::String

winrt::hstring

Argumentos para ejecutar el proceso.

Devoluciones

Cuando se completa la operación asincrónica, contiene el código de salida del proceso iniciado.

Atributos

Requisitos de Windows

Características de aplicaciones
systemManagement

Comentarios

Esta API requiere el uso de la funcionalidad systemManagement de IoT y la inclusión de iot en la lista ignoreableNamespaces de . Los usuarios pueden agregar lo siguiente a su Package.appmanifest: <iot:Capability Name="systemManagement"/>y agregar iot a su lista existente de IgnorableNamespaces.

Para iniciar un proceso, el .exe debe estar incluido en el paquete .appx o estar registrado en la lista de permitidos para esta API. Para agregar un .exe a la lista de permitidos, modifique HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowedExecutableFilesList y agregue el archivo ejecutable a la cadena con formato REG_MULTI_SZ.

Por ejemplo:

reg ADD "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher" /f /v AllowedExecutableFilesList /t REG_MULTI_SZ /d "c:\windows\system32\cmd.exe\0"

Consulte también

Se aplica a

RunToCompletionAsync(String, String, ProcessLauncherOptions)

Inicia un nuevo proceso, incluidas las opciones especificadas. Esta función asincrónica se completa cuando finaliza el proceso iniciado.

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

Nombre de archivo del proceso que se va a iniciar.

args
String

Platform::String

winrt::hstring

Argumentos para el proceso especificado.

options
ProcessLauncherOptions

Opciones asociadas para ejecutar el proceso.

Devoluciones

Cuando se completa la operación asincrónica, contiene el código de salida del proceso iniciado.

Atributos

Requisitos de Windows

Características de aplicaciones
systemManagement

Comentarios

Esta API requiere el uso de la funcionalidad systemManagement de IoT y la inclusión de iot en la lista ignoreableNamespaces de . Los usuarios pueden agregar lo siguiente a su Package.appmanifest: <iot:Capability Name="systemManagement"/>y agregar iot a su lista existente de IgnorableNamespaces.

Para iniciar un proceso, el .exe debe estar incluido en el paquete .appx o estar registrado en la lista de permitidos para esta API. Para agregar un .exe a la lista de permitidos, modifique HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowedExecutableFilesList y agregue el archivo ejecutable a la cadena con formato REG_MULTI_SZ.

Por ejemplo:

reg ADD "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher" /f /v AllowedExecutableFilesList /t REG_MULTI_SZ /d "c:\windows\system32\cmd.exe\0"

Consulte también

Se aplica a