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) |