Partager via


ProcessLauncher.RunToCompletionAsync Méthode

Définition

Surcharges

RunToCompletionAsync(String, String)

Lance un nouveau processus. Cette fonction asynchrone se termine lorsque le processus lancé se termine.

RunToCompletionAsync(String, String, ProcessLauncherOptions)

Lance un nouveau processus, y compris les options spécifiées. Cette fonction asynchrone se termine lorsque le processus lancé se termine.

RunToCompletionAsync(String, String)

Lance un nouveau processus. Cette fonction asynchrone se termine lorsque le processus lancé se termine.

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)

Paramètres

fileName
String

Platform::String

winrt::hstring

Nom du processus à lancer.

args
String

Platform::String

winrt::hstring

Arguments pour l’exécution du processus.

Retours

Une fois l’opération asynchrone terminée, elle contient le code de sortie du processus lancé.

Attributs

Configuration requise pour Windows

Fonctionnalités de l’application
systemManagement

Remarques

Cette API nécessite l’utilisation de la fonctionnalité de systemManagement ioT et l’inclusion de iot dans la liste IgnorableNamespaces. Les utilisateurs peuvent ajouter les éléments suivants à leur Package.appmanifest: <iot:Capability Name="systemManagement"/>et ajouter iot à leur liste existante d'IgnoreableNamespaces.

Pour lancer un processus, le .exe doit être contenu dans le package .appx ou être inscrit dans la liste verte de cette API. Pour ajouter un .exe à la liste verte, modifiez HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher :AllowedExecutableFilesList et ajoutez votre exécutable à la chaîne mise en forme REG_MULTI_SZ.

Par exemple:

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

Voir aussi

S’applique à

RunToCompletionAsync(String, String, ProcessLauncherOptions)

Lance un nouveau processus, y compris les options spécifiées. Cette fonction asynchrone se termine lorsque le processus lancé se termine.

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)

Paramètres

fileName
String

Platform::String

winrt::hstring

Nom de fichier du processus à démarrer.

args
String

Platform::String

winrt::hstring

Arguments pour le processus spécifié.

options
ProcessLauncherOptions

Options associées pour l’exécution du processus.

Retours

Une fois l’opération asynchrone terminée, elle contient le code de sortie du processus lancé.

Attributs

Configuration requise pour Windows

Fonctionnalités de l’application
systemManagement

Remarques

Cette API nécessite l’utilisation de la fonctionnalité de systemManagement ioT et l’inclusion de iot dans la liste IgnorableNamespaces. Les utilisateurs peuvent ajouter les éléments suivants à leur Package.appmanifest: <iot:Capability Name="systemManagement"/>et ajouter iot à leur liste existante d'IgnoreableNamespaces.

Pour lancer un processus, le .exe doit être contenu dans le package .appx ou être inscrit dans la liste verte de cette API. Pour ajouter un .exe à la liste verte, modifiez HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher :AllowedExecutableFilesList et ajoutez votre exécutable à la chaîne mise en forme REG_MULTI_SZ.

Par exemple:

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

Voir aussi

S’applique à