ProcessLauncher.RunToCompletionAsync Methode

Definition

Namespace:

Windows.System

Überlädt

RunToCompletionAsync(String, String)	Startet einen neuen Prozess. Diese asynchrone Funktion wird abgeschlossen, wenn der gestartete Prozess beendet wird.
RunToCompletionAsync(String, String, ProcessLauncherOptions)	Startet einen neuen Prozess, einschließlich der angegebenen Optionen. Diese asynchrone Funktion wird abgeschlossen, wenn der gestartete Prozess beendet wird.

RunToCompletionAsync(String, String)

Startet einen neuen Prozess. Diese asynchrone Funktion wird abgeschlossen, wenn der gestartete Prozess beendet wird.

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)

Parameter

fileName

String

Platform::String

winrt::hstring

Der Name des zu startenden Prozesses.

args

String

Platform::String

winrt::hstring

Argumente zum Ausführen des Prozesses.

Gibt zurück

IAsyncOperation<ProcessLauncherResult>

Wenn der asynchrone Vorgang abgeschlossen ist, enthält er den Exitcode aus dem gestarteten Prozess.

Attribute

OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

App-Funktionen

systemManagement

Hinweise

Diese API erfordert die Verwendung der IoT-SystemVerwaltungsfunktion und die Aufnahme von iot in die Liste IgnorableNamespaces . Benutzer können ihrem Package.appmanifest: <iot:Capability Name="systemManagement"/> Folgendes hinzufügen und iot der vorhandenen Liste von IgnorableNamespaces hinzufügen.

Um einen Prozess zu starten, muss die .exe entweder im APPX-Paket enthalten sein oder in der Whitelist für diese API registriert sein. Um der Whitelist ein .exe hinzuzufügen, ändern Sie HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowedExecutableFilesList , und fügen Sie Ihre ausführbare Datei der REG_MULTI_SZ formatierten Zeichenfolge hinzu.

Beispiel:

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

Weitere Informationen

• RunToCompletionAsync(String, String, ProcessLauncherOptions)

RunToCompletionAsync(String, String, ProcessLauncherOptions)

Startet einen neuen Prozess, einschließlich der angegebenen Optionen. Diese asynchrone Funktion wird abgeschlossen, wenn der gestartete Prozess beendet wird.

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)

Parameter

fileName

String

Platform::String

winrt::hstring

Dateiname des zu startenden Prozesses.

args

String

Platform::String

winrt::hstring

Argumente für den angegebenen Prozess.

options

ProcessLauncherOptions

Zugeordnete Optionen zum Ausführen des Prozesses.

Gibt zurück

IAsyncOperation<ProcessLauncherResult>

Wenn der asynchrone Vorgang abgeschlossen ist, enthält er den Exitcode aus dem gestarteten Prozess.

Attribute

OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

App-Funktionen

systemManagement

Hinweise

Diese API erfordert die Verwendung der IoT-SystemVerwaltungsfunktion und die Aufnahme von iot in die Liste IgnorableNamespaces . Benutzer können ihrem Package.appmanifest: <iot:Capability Name="systemManagement"/> Folgendes hinzufügen und iot der vorhandenen Liste von IgnorableNamespaces hinzufügen.

Um einen Prozess zu starten, muss die .exe entweder im APPX-Paket enthalten sein oder in der Whitelist für diese API registriert sein. Um der Whitelist ein .exe hinzuzufügen, ändern Sie HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowedExecutableFilesList , und fügen Sie Ihre ausführbare Datei der REG_MULTI_SZ formatierten Zeichenfolge hinzu.

Beispiel:

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

Weitere Informationen

• RunToCompletionAsync(String, String)