IAttachmentExecute ::Execute, méthode (shobjidl_core.h)

  • Article

Exécute une action sur une pièce jointe.

Syntaxe

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

Paramètres

[in] hwnd

Type : HWND

Handle de la fenêtre parente.

[in, optional] pszVerb

Type : LPCWSTR

Pointeur vers une chaîne terminée par null qui contient un verbe spécifiant l’action à effectuer sur le fichier. Pour connaître les chaînes valides, consultez le paramètre lpOperation dans ShellExecute . Cette valeur peut être NULL.

[out, optional] phProcess

Type : HANDLE*

Pointeur vers un handle vers le processus source, utilisé pour l’opération synchrone. Cette valeur peut être NULL.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Avant d’appeler IAttachmentExecute ::Execute, IAttachmentExecute ::SetLocalPath doit être appelé avec un chemin local valide et le fichier doit être copié à cet emplacement.

Si une invite est indiquée, IAttachmentExecute ::Execute appelle IAttachmentExecute ::P rompt à l’aide de la valeur ATTACHMENT_ACTION_EXEC .

IAttachmentExecute ::Execute peut exécuter des antivirus ou d’autres services d’approbation pour valider le fichier avant de l’exécuter. Notez que ces services peuvent supprimer ou modifier le fichier.

IAttachmentExecute ::Execute peut joindre des preuves au chemin d’accès local dans son autre flux de données NTFS (ADS).

Si phProcess n’a pas la valeur NULL, IAttachmentExecute ::Execute fonctionne comme un processus synchrone et retourne un HPROCESS, si disponible. Si phProcess a la valeur NULL, IAttachmentExecute ::Execute fonctionne comme un processus asynchrone. Cela implique que l’application appelante dispose d’une pompe à messages et d’une fenêtre de longue durée.

Si le handle pointé par phProcess n’est pas NULL lorsque la méthode est retournée, l’application appelante est chargée d’appeler CloseHandle pour libérer le handle quand il n’est plus nécessaire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)
DLL Shdocvw.dll (version 6.0 ou ultérieure)