ProcessLauncher.RunToCompletionAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| 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
Аргументы для выполнения процесса.
Возвращаемое значение
После завершения асинхронной операции он содержит код выхода из запущенного процесса.
- Атрибуты
Требования к 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)
Запускает новый процесс, включая указанные параметры. Эта асинхронная функция завершается после завершения запущенного процесса.
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
Связанные параметры выполнения процесса.
Возвращаемое значение
После завершения асинхронной операции он содержит код выхода из запущенного процесса.
- Атрибуты
Требования к 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"