Metodo IPortableDevicePropertiesBulkCallback::OnProgress (portabledeviceapi.h)

Il metodo OnProgress viene chiamato dall'SDK quando un'operazione in blocco avviata da IPortableDevicePropertiesBulk::Start ha inviato dati al dispositivo e ha ricevuto alcune informazioni.

Sintassi

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

Parametri

[in] pContext

Puntatore a un GUID che identifica l'operazione in corso. Questo valore viene prodotto da un oggetto Queue... metodo dell'interfaccia IPortableDevicePropertiesBulk .

[in] pResults

Puntatore a un'interfaccia IPortableDeviceValuesCollection che contiene i risultati recuperati dal dispositivo. Questa interfaccia conterrà una o più interfacce IPortableDeviceValues . Ognuna di queste interfacce conterrà una proprietà WPD_OBJECT_ID con un valore stringa (VT_LPSTR) specificando l'ID oggetto dell'oggetto a cui questi valori riguardano. Il resto dei valori in ogni interfaccia IPortableDeviceValues varia a seconda dell'operazione in blocco segnalata. Per i metodi QueueGetValuesByObjectFormat e QueueGetValuesByObjectList , verranno recuperati valori di tipi variabili. Per QueueSetValuesByObjectList, verranno VT_ERROR valori HRESULT per eventuali errori rilevati durante l'impostazione dei valori.

Valore restituito

L'applicazione deve restituire S_OK o un codice di errore per abbandonare l'operazione. Tutti i codici di errore vengono gestiti allo stesso modo.

Commenti

Questo metodo può essere chiamato una volta o più volte, a seconda della dimensione dell'operazione.

Questo metodo non recupera necessariamente tutte le proprietà contemporaneamente, né restituisce le proprietà in un ordine specifico.

Se questo metodo viene chiamato più volte, può restituire proprietà per lo stesso identificatore di oggetto ogni volta.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDevicePropertiesBulkCallback