IAttachmentExecute ::Execute, méthode (shobjidl_core.h)
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) |