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

Статья
03/02/2024

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

Синтаксис

HRESULT BeforeCoCreateInstance(
  [in] REFCLSID        clsidHandler,
  [in] IShellItemArray *itemsBeingActivated,
  [in] IHandlerInfo    *handlerInfo
);

Параметры

[in] clsidHandler

Идентифицирует обработчик.

[in] itemsBeingActivated

Объекты элементов оболочки, которые будут переданы обработчику. Как правило, существует только один, но в некоторых случаях может быть несколько.

[in] handlerInfo

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

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

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

Требования

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

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

IHandlerActivationHost

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