Metodo IAttachmentExecute::Execute (shobjidl_core.h)

Esegue un'azione su un allegato.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle della finestra padre.

[in, optional] pszVerb

Tipo: LPCWSTR

Puntatore a una stringa con terminazione Null contenente un verbo che specifica l'azione da eseguire nel file. Per le stringhe valide, vedere il parametro lpOperation in ShellExecute . Questo valore può essere NULL.

[out, optional] phProcess

Tipo: HANDLE*

Puntatore a un handle al processo di origine, usato per l'operazione sincrona. Questo valore può essere NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Prima di chiamare IAttachmentExecute::Execute, IAttachmentExecute::SetLocalPath deve essere chiamato con un percorso locale valido e il file deve essere copiato in tale percorso.

Se viene indicato un prompt, IAttachmentExecute::Execute chiama IAttachmentExecute::P rompt usando il valore ATTACHMENT_ACTION_EXEC .

IAttachmentExecute::Execute può eseguire scanner antivirus o altri servizi di trust per convalidare il file prima di eseguirlo. Si noti che questi servizi possono eliminare o modificare il file.

IAttachmentExecute::Execute può allegare prove al percorso locale nel flusso di dati alternativo NTFS (ADS).

Se phProcess non è NULL, IAttachmentExecute::Execute opera come processo sincrono e restituisce un HPROCESS, se disponibile. Se phProcess è NULL, IAttachmentExecute::Execute opera come processo asincrono. Ciò implica che l'applicazione chiamante ha un message pump e una finestra di lunga durata.

Se l'handle a cui punta phProcess non è NULL quando termina, l'applicazione chiamante è responsabile della chiamata di CloseHandle per liberare l'handle quando non è più necessario.

Requisiti