Método IHandlerActivationHost::BeforeCoCreateInstance (shobjidl_core.h)
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) |