Método IAttachmentExecute::Execute (shobjidl_core.h)

Executa uma ação em um anexo.

Sintaxe

HRESULT Execute(
  [in]            HWND    hwnd,
  [in, optional]  LPCWSTR pszVerb,
  [out, optional] HANDLE  *phProcess
);

Parâmetros

[in] hwnd

Digite: HWND

O identificador da janela pai.

[in, optional] pszVerb

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém um verbo especificando a ação a ser executada no arquivo. Consulte o parâmetro lpOperation em ShellExecute para obter cadeias de caracteres válidas. Esse valor pode ser NULL.

[out, optional] phProcess

Tipo: HANDLE*

Um ponteiro para um identificador para o processo de origem, usado para operação síncrona. Esse valor pode ser NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Antes de chamar IAttachmentExecute::Execute, IAttachmentExecute::SetLocalPath deve ser chamado com um caminho local válido e o arquivo deve ser copiado para esse local.

Se um prompt for indicado, IAttachmentExecute::Execute chamaráIAttachmentExecute::P rompt usando o valor ATTACHMENT_ACTION_EXEC .

IAttachmentExecute::Execute pode executar scanners de vírus ou outros serviços de confiança para validar o arquivo antes de executá-lo. Observe que esses serviços podem excluir ou alterar o arquivo.

IAttachmentExecute::Execute pode anexar evidências ao caminho local em seu ADS (fluxo de dados alternativo) NTFS.

Se phProcess não for NULL, IAttachmentExecute::Execute funcionará como um processo síncrono e retornará um HPROCESS, se disponível. Se phProcess for NULL, IAttachmentExecute::Execute funcionará como um processo assíncrono. Isso implica que o aplicativo de chamada tem uma bomba de mensagem e uma janela de longa duração.

Se o identificador apontado por phProcess não for NULL quando o método retornar, o aplicativo de chamada será responsável por chamar CloseHandle para liberar o identificador quando ele não for mais necessário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shdocvw.dll (versão 6.0 ou posterior)