IPortableDevicePropertiesBulkCallback ::OnProgress, méthode (portabledeviceapi.h)

  • Article

La méthode OnProgress est appelée par le SDK lorsqu’une opération en bloc démarrée par IPortableDevicePropertiesBulk ::Start a envoyé des données à l’appareil et a reçu certaines informations.

Syntaxe

HRESULT OnProgress(
  [in] REFGUID                         pContext,
  [in] IPortableDeviceValuesCollection *pResults
);

Paramètres

[in] pContext

Pointeur vers un GUID qui identifie l’opération en cours. Cette valeur est produite par une file d’attente... de l’interface IPortableDevicePropertiesBulk .

[in] pResults

Pointeur vers une interface IPortableDeviceValuesCollection qui contient les résultats récupérés à partir de l’appareil. Cette interface contiendra une ou plusieurs interfaces IPortableDeviceValues . Chacune de ces interfaces contient une propriété WPD_OBJECT_ID avec une valeur de chaîne (VT_LPSTR) spécifiant l’ID d’objet de l’objet auquel ces valeurs se rapportent. Le reste des valeurs de chaque interface IPortableDeviceValues varie en fonction de l’opération en bloc signalée. Pour les méthodes QueueGetValuesByObjectFormat et QueueGetValuesByObjectList , il s’agit de valeurs récupérées de différents types. Pour QueueSetValuesByObjectList, elles seront VT_ERROR valeurs HRESULT pour toutes les erreurs rencontrées lors de la définition de valeurs.

Valeur retournée

L’application doit retourner soit S_OK, soit un code d’erreur pour abandonner l’opération. Tous les codes d’erreur sont gérés de la même façon.

Remarques

Cette méthode peut être appelée une ou plusieurs fois, selon la taille de l’opération.

Cette méthode ne récupère pas nécessairement toutes les propriétés en même temps et ne retourne pas les propriétés dans un ordre particulier.

Si cette méthode est appelée plusieurs fois, elle peut retourner des propriétés pour le même identificateur d’objet à chaque fois.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête portabledeviceapi.h
Bibliothèque PortableDeviceGUIDs.lib

Voir aussi

IPortableDevicePropertiesBulkCallback, interface