Share via

IPortableDevicePropertiesBulk::QueueGetValuesByObjectList

  • Article

banner art

Previous Next

IPortableDevicePropertiesBulk::QueueGetValuesByObjectList

The QueueGetValuesByObjectList method queues a request for one or more specified properties from one or more specified objects on the device.

Syntax

  HRESULT QueueGetValuesByObjectList(
  IPortableDevicePropVariantCollection*  pObjectIDs,
  IPortableDeviceKeyCollection*  pKeys,
  IPortableDevicePropertiesBulkCallback*  pCallback,
  GUID*  pContext
);

Parameters

pObjectIDs

[in]  Pointer to an IPortableDevicePropVariantCollection interface that lists the object IDs of all the objects to query. These will be of type VT_LPWSTR.

pKeys

[in]  Pointer to an IPortableDeviceKeyCollection interface that specifies the properties to request. For a list of properties defined by Windows Portable Devices, see Properties and Attributes. Specify NULL to indicate all properties from the specified objects.

pCallback

[in]  Pointer to an application-implemented IPortableDevicePropertiesBulkCallback interface that will receive the information as it is retrieved.

pContext

[out]  Pointer to a GUID that is used to start, cancel, or identify the request IPortableDevicePropertiesBulkCallback callbacks, if implemented.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Remarks

The queued request is not started until the application calls Start. For more information on how to use this method, see IPortableDevicePropertiesBulk Interface.

Due to performance issues, some devices may not return a comprehensive list of properties when the pKeys parameter is NULL.

Requirements

Header: Defined in PortableDeviceApi.h

Library: PortableDeviceGUIDs.lib

See Also

Previous Next