IFileOperation ::Advise, méthode (shobjidl_core.h)

Permet à un gestionnaire de fournir des informations de status et d’erreur pour toutes les opérations.

Syntaxe

HRESULT Advise(
  [in]  IFileOperationProgressSink *pfops,
  [out] DWORD                      *pdwCookie
);

Paramètres

[in] pfops

Type : IFileOperationProgressSink*

Pointeur vers un objet IFileOperationProgressSink à utiliser pour les notifications de status de progression et d’erreur.

[out] pdwCookie

Type : DWORD*

Lorsque cette méthode est retournée, ce paramètre pointe vers un jeton retourné qui identifie de façon unique cette connexion. L’application appelante utilise ce jeton ultérieurement pour supprimer la connexion en le transmettant à IFileOperation ::Unadvise. Si l’appel à Conseiller échoue, cette valeur n’a aucun sens.

Valeur retournée

Type : HRESULT

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

Remarques

Plusieurs méthodes individuelles ont la possibilité de déclarer leurs propres récepteurs de progression, qui sont redondants par rapport à celui défini ici. Ils sont utilisés lorsque vous souhaitez recevoir uniquement des informations sur la progression et les erreurs d’une opération spécifique.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)

Voir aussi

IFileOperation

IFileOperation ::Unadvise