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 требуется использование systemManagement IoT, а также включение iot в список игнорируемых имен. Пользователи могут добавить следующее в свой Package.appmanifest: <iot:Capability Name="systemManagement"/>и добавить iot в существующий список игнорируемых имен.

Чтобы запустить процесс, .exe должен содержаться в пакете .appx или быть зарегистрирован в списке разрешений для этого API. Чтобы добавить .exe в список разрешений, измените HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowExecutableFilesList и добавьте исполняемый файл в строку 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 требуется использование systemManagement IoT, а также включение iot в список игнорируемых имен. Пользователи могут добавить следующее в свой Package.appmanifest: <iot:Capability Name="systemManagement"/>и добавить iot в существующий список игнорируемых имен.

Чтобы запустить процесс, .exe должен содержаться в пакете .appx или быть зарегистрирован в списке разрешений для этого API. Чтобы добавить .exe в список разрешений, измените HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\EmbeddedMode\ProcessLauncher:AllowExecutableFilesList и добавьте исполняемый файл в строку 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)