Método IHandlerActivationHost::BeforeCoCreateInstance (shobjidl_core.h)

Artículo
03/02/2024

Notifica a un cliente de ShellExecuteEx que está a punto de crearse un controlador, lo que proporciona al cliente la oportunidad de mostrar la interfaz de usuario que confirma el uso de ese controlador o rechazarlo devolviendo un código de error específico.

Sintaxis

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

Parámetros

[in] clsidHandler

Identifica el controlador.

[in] itemsBeingActivated

Objetos de elemento de Shell que se pasarán al controlador. Normalmente solo hay uno, pero en algunos casos puede haber más de uno.

[in] handlerInfo

Proporciona acceso a información sobre el controlador que se invocará. Este objeto también admite IHandlerInfo2 en versiones de Windows que admiten esa interfaz.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT , HRESULT_FROM_WIN32(ERROR_CANCELLED) indica que se debe cancelar la llamada ShellExecute, EXECUTE_E_LAUNCH_APPLICATION indica que no se debe usar este controlador, pero si hay otro que se debe usar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)

Consulte también

IHandlerActivationHost

Share via