Método IPortableDevicePropertiesBulk::QueueSetValuesByObjectList (portabledeviceapi.h)

O método QueueSetValuesByObjectList enfileira uma solicitação para definir um ou mais valores especificados em um ou mais objetos especificados no dispositivo.

Sintaxe

HRESULT QueueSetValuesByObjectList(
  [in]  IPortableDeviceValuesCollection       *pObjectValues,
  [in]  IPortableDevicePropertiesBulkCallback *pCallback,
  [out] GUID                                  *pContext
);

Parâmetros

[in] pObjectValues

Ponteiro para uma interface IPortableDeviceValuesCollection que contém as propriedades e os valores a serem definidos em objetos especificados. Essa interface contém uma ou mais interfaces IPortableDeviceValues , cada uma representando um único objeto. Cada interface IPortableDeviceValues contém uma coleção de pares chave/valor, em que a chave é PROPERTYKEY que identifica a propriedade e o valor é um tipo de dados que varia de acordo com a propriedade. Cada interface IPortableDeviceValues também contém uma propriedade WPD_OBJECT_ID que identifica o objeto ao qual essa interface se refere.

[in] pCallback

Ponteiro para uma interface IPortableDevicePropertiesBulkCallback implementada pelo aplicativo que receberá as informações conforme elas forem recuperadas.

[out] pContext

Ponteiro para um GUID usado para iniciar, cancelar ou identificar a solicitação para quaisquer retornos de chamada IPortableDevicePropertiesBulkCallback implementados pelo cliente.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	A operação foi enfileirada com êxito.

Comentários

A solicitação na fila não é iniciada até que o aplicativo chame Iniciar. Para obter mais informações sobre como usar esse método, consulte Interface IPortableDevicePropertiesBulk.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDevicePropertiesBulk Interface

IPortableDevicePropertiesBulk::QueueGetValuesByObjectList