Método IPortableDevicePropertiesBulkCallback::OnProgress (portabledeviceapi.h)

O método OnProgress é chamado pelo SDK quando uma operação em massa iniciada por IPortableDevicePropertiesBulk::Start enviou dados para o dispositivo e recebeu algumas informações de volta.

Sintaxe

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

Parâmetros

[in] pContext

Ponteiro para um GUID que identifica qual operação está em andamento. Esse valor é produzido por uma Fila... método da interface IPortableDevicePropertiesBulk .

[in] pResults

Ponteiro para uma interface IPortableDeviceValuesCollection que contém os resultados recuperados do dispositivo. Essa interface conterá uma ou mais interfaces IPortableDeviceValues . Cada uma dessas interfaces conterá uma propriedade WPD_OBJECT_ID com um valor de cadeia de caracteres (VT_LPSTR) especificando a ID do objeto ao qual esses valores pertencem. O restante dos valores em cada interface IPortableDeviceValues varia, dependendo da operação em massa que está sendo relatada. Para os métodos QueueGetValuesByObjectFormat e QueueGetValuesByObjectList , eles serão recuperados valores de tipos variados. Para QueueSetValuesByObjectList, eles serão VT_ERROR valores HRESULT para quaisquer erros encontrados ao definir valores.

Retornar valor

O aplicativo deve retornar S_OK ou um código de erro para abandonar a operação. Todos os códigos de erro são tratados da mesma maneira.

Comentários

Esse método pode ser chamado uma ou várias vezes, dependendo do tamanho da operação.

Esse método não recupera necessariamente todas as propriedades de uma só vez, nem retorna as propriedades em uma ordem específica.

Se esse método for chamado várias vezes, ele poderá retornar propriedades para o mesmo identificador de objeto cada vez.

Requisitos

Confira também

IPortableDevicePropertiesBulkCallback Interface