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

Notifica um cliente do ShellExecuteEx de que um manipulador está prestes a ser criado, dando a esse cliente a oportunidade de exibir a interface do usuário confirmando o uso desse manipulador ou rejeitando-o retornando um código de erro específico.

Sintaxe

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

Parâmetros

[in] clsidHandler

Identifica o manipulador.

[in] itemsBeingActivated

Os objetos de item do Shell que serão passados para o manipulador. Normalmente, há apenas um, mas em alguns casos pode haver mais de um.

[in] handlerInfo

Fornece acesso a informações sobre o manipulador que será invocado. Esse objeto também dá suporte a IHandlerInfo2 em versões do Windows que dão suporte a essa interface.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retorna um código de erro HRESULT , HRESULT_FROM_WIN32(ERROR_CANCELLED) indica que a chamada ShellExecute deve ser cancelada, EXECUTE_E_LAUNCH_APPLICATION indica que esse manipulador não deve ser usado, mas se houver outro, ele deve ser usado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

IHandlerActivationHost