IPortableDeviceService ::Advise, méthode (portabledeviceapi.h)

Article
03/01/2024

La méthode Advise inscrit un objet de rappel défini par l’application qui reçoit des événements de service.

Syntaxe

HRESULT Advise(
  [in]  const DWORD                  dwFlags,
  [in]  IPortableDeviceEventCallback *pCallback,
  [in]  IPortableDeviceValues        *pParameters,
  [out] LPWSTR                       *ppszCookie
);

Paramètres

[in] dwFlags

Non utilisé.

[in] pCallback

Interface IPortableDeviceEventCallback spécifiant l’objet de rappel à inscrire.

[in] pParameters

Interface IPortableDeviceValues spécifiant les paramètres d’inscription d’événement, ou NULL si l’objet de rappel doit recevoir tous les événements de service.

[out] ppszCookie

ID de contexte unique pour l’objet de rappel. Cette valeur correspond à celle utilisée par la méthode Unadvise pour annuler l’inscription de l’objet de rappel.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_POINTER	Une valeur NULL a été spécifiée pour le paramètre pCallback ou le paramètre ppszCookie .

Remarques

Pendant le nettoyage, une application doit annuler l’inscription de l’objet de rappel en appelant la méthode Unadvise , puis libérer la mémoire référencée par le paramètre ppszCookie en appelant la fonction CoTaskMemFree .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	portabledeviceapi.h

Voir aussi

IPortableDeviceService, interface

Partager via