Partager via


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

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