Compartir a través de

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

  • Artículo

Ejecuta una acción en un archivo adjunto.

Sintaxis

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

Parámetros

[in] hwnd

Tipo: HWND

Identificador de la ventana primaria.

[in, optional] pszVerb

Tipo: LPCWSTR

Puntero a una cadena terminada en null que contiene un verbo que especifica la acción que se va a realizar en el archivo. Consulte el parámetro lpOperation en ShellExecute para obtener cadenas válidas. Este valor puede ser NULL.

[out, optional] phProcess

Tipo: HANDLE*

Puntero a un identificador del proceso de origen, que se usa para la operación sincrónica. Este valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Antes de llamar a IAttachmentExecute::Execute, se debe llamar a IAttachmentExecute::SetLocalPath con una ruta de acceso local válida y el archivo debe copiarse en esa ubicación.

Si se indica un símbolo del sistema, IAttachmentExecute::Execute llama a IAttachmentExecute::P rompt mediante el valor de ATTACHMENT_ACTION_EXEC .

IAttachmentExecute::Execute puede ejecutar escáneres de virus u otros servicios de confianza para validar el archivo antes de ejecutarlo. Tenga en cuenta que estos servicios pueden eliminar o modificar el archivo.

IAttachmentExecute::Execute puede adjuntar evidencia a la ruta de acceso local en su flujo de datos alternativo ntfs (ADS).

Si phProcess no es NULL, IAttachmentExecute::Execute funciona como un proceso sincrónico y devuelve un HPROCESS, si está disponible. Si phProcess es NULL, IAttachmentExecute::Execute funciona como un proceso asincrónico. Esto implica que la aplicación que llama tiene una bomba de mensajes y una ventana de larga duración.

Si el identificador al que apunta phProcess no es NULL cuando el método devuelve, la aplicación que realiza la llamada es responsable de llamar a CloseHandle para liberar el identificador cuando ya no sea necesario.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Archivo DLL Shdocvw.dll (versión 6.0 o posterior)