IPortableDevicePropertiesBulkCallback ::OnProgress, méthode (portabledeviceapi.h)
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 |