Метод IHandlerActivationHost::BeforeCreateProcess (shobjidl_core.h)

Статья
08/26/2023

Уведомляет клиента ShellExecuteEx о том, что процесс будет создан, предоставляя клиенту возможность отобразить пользовательский интерфейс, подтверждающий это, или отклонить его, возвращая определенный код ошибки.

Синтаксис

HRESULT BeforeCreateProcess(
  [in] LPCWSTR      applicationPath,
  [in] LPCWSTR      commandLine,
  [in] IHandlerInfo *handlerInfo
);

Параметры

[in] applicationPath

Полный путь к исполняемому файлу процесса или, в некоторых случаях, путь dll.

[in] commandLine

Полная командная строка, которая будет передана в CreateProcess , включая аргументы, запрошенные обработчиком через регистрацию.

[in] handlerInfo

Предоставляет доступ к сведениям о вызываемом обработчике. Этот объект также поддерживает IHandlerInfo2 в версиях windows, поддерживающих этот интерфейс. Этот объект также реализует IObjectWithSelection. Это можно использовать для получения элемента оболочки или в некоторых случаях элементов, которые запускаются.

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT , HRESULT_FROM_WIN32(ERROR_CANCELLED) указывает, что вызов ShellExecute следует отменить.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)

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

IHandlerActivationHost

Поделиться через