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

Artigo
08/26/2023

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

Sintaxe

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

Parâmetros

[in] applicationPath

O caminho totalmente qualificado para o executável do processo ou, em alguns casos, um caminho de DLL.

[in] commandLine

A linha de comando completa que será passada para CreateProcess , incluindo os argumentos que o manipulador solicitou por meio de seu registro.

[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. Esse objeto também implementa IObjectWithSelection. Isso pode ser usado para obter o item shell, ou itens, em alguns casos, que estão sendo iniciados.

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.

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

Share via