ProcessLauncher.RunToCompletionAsync Метод

Определение

Пространство имен:

Windows.System

Перегрузки

RunToCompletionAsync(String, String)	Запускает новый процесс. Эта асинхронная функция завершается после завершения запущенного процесса.
RunToCompletionAsync(String, String, ProcessLauncherOptions)	Запускает новый процесс, включая указанные параметры. Эта асинхронная функция завершается после завершения запущенного процесса.

RunToCompletionAsync(String, String)

Запускает новый процесс. Эта асинхронная функция завершается после завершения запущенного процесса.

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)

Параметры

fileName

String

Platform::String

winrt::hstring

Имя запускаемого процесса.

args

String

Platform::String

winrt::hstring

Аргументы для запуска процесса.

Возвращаемое значение

IAsyncOperation<ProcessLauncherResult>

После завершения асинхронной операции он содержит код выхода из запущенного процесса.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Возможности приложения

systemManagement

Комментарии

Этот API требует использования возможности IoT systemManagement и включения iot в список IgnorableNamespaces . Пользователи могут добавить следующее в package.appmanifest: <iot:Capability Name="systemManagement"/>, а также добавить iot в существующий список IgnorableNamespaces.

Чтобы запустить процесс, .exe должен содержаться в пакете APPX или быть зарегистрирован в списке разрешений для этого API. Чтобы добавить .exe в список разрешений, измените HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowedExecutableFilesList и добавьте исполняемый файл в REG_MULTI_SZ форматированную строку.

Пример:

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

См. также раздел

• RunToCompletionAsync(String, String, ProcessLauncherOptions)

RunToCompletionAsync(String, String, ProcessLauncherOptions)

Запускает новый процесс, включая указанные параметры. Эта асинхронная функция завершается после завершения запущенного процесса.

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)

Параметры

fileName

String

Platform::String

winrt::hstring

Имя файла запускаемого процесса.

args

String

Platform::String

winrt::hstring

Аргументы для указанного процесса.

options

ProcessLauncherOptions

Связанные параметры для запуска процесса.

Возвращаемое значение

IAsyncOperation<ProcessLauncherResult>

После завершения асинхронной операции он содержит код выхода из запущенного процесса.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Возможности приложения

systemManagement

Комментарии

Этот API требует использования возможности IoT systemManagement и включения iot в список IgnorableNamespaces . Пользователи могут добавить следующее в package.appmanifest: <iot:Capability Name="systemManagement"/>, а также добавить iot в существующий список IgnorableNamespaces.

Чтобы запустить процесс, .exe должен содержаться в пакете APPX или быть зарегистрирован в списке разрешений для этого API. Чтобы добавить .exe в список разрешений, измените HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowedExecutableFilesList и добавьте исполняемый файл в REG_MULTI_SZ форматированную строку.

Пример:

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

См. также раздел

• RunToCompletionAsync(String, String)