IPortableDeviceValues interface
The IPortableDeviceValues interface holds a collection of PROPERTYKEY/PROPVARIANT pairs. Values in the collection do not need to be the same VARTYPE.
Values are stored as key-value pairs; each key must be unique in the collection. Clients can search for items by PROPERTYKEY or zero-based index. Data values are stored as PROPVARIANT structures. You can add or retrieve values of any type by using the generic methods SetValue and GetValue, or you add items by using the method specific to the type of data added.
The Get... methods require the caller to release any retrieved values appropriately. The Set... methods copy the value into the collection.
When an IPortableDeviceValues interface is released, it calls Clear, which frees the memory that was allocated for all its members appropriately.
This interface can be retrieved from a method or, if a new object is required, call CoCreate with CLSID_PortableDeviceValues.
Members
The IPortableDeviceValues interface inherits from the IUnknown interface. IPortableDeviceValues also has these types of members:
Methods
The IPortableDeviceValues interface has these methods.
| Method | Description |
|---|---|
| Clear | Deletes all items from the collection. |
| CopyValuesFromPropertyStore | Copies the contents of an IPropertyStore into the collection. |
| CopyValuesToPropertyStore | Copies all the values from a collection into an IPropertyStore interface. |
| GetAt | Retrieves a value from the collection using the supplied zero-based index. |
| GetBoolValue | Retrieves a BOOL value (type VT_BOOL) specified by a key. |
| GetBufferValue | Retrieves a byte array value (type VT_VECTOR | VT_UI1) specified by a key. |
| GetCount | Retrieves the number of items in the collection. |
| GetErrorValue | Retrieves an HRESULT value (type VT_ERROR) specified by a key. |
| GetFloatValue | Retrieves a FLOAT value (type VT_R4) specified by a key. |
| GetGuidValue | Retrieves a GUID value (type VT_CLSID) specified by a key. |
| GetIPortableDeviceKeyCollectionValue | Retrieves an IPortableDeviceKeyCollection value (type VT_UNKNOWN) specified by a key. |
| GetIPortableDevicePropVariantCollectionValue | Retrieves an IPortableDevicePropVariantCollection value (type VT_UNKNOWN) specified by a key. |
| GetIPortableDeviceValuesCollectionValue | Retrieves an IPortableDeviceValuesCollection value (type VT_UNKNOWN) specified by a key. |
| GetIPortableDeviceValuesValue | Retrieves an IPortableDeviceValues value (type VT_UNKNOWN) specified by a key. |
| GetIUnknownValue | Retrieves an IUnknown interface value (type VT_UNKNOWN) specified by a key. |
| GetKeyValue | Retrieves a PROPERTYKEY value specified by a key. |
| GetSignedIntegerValue | Retrieves a LONG value (type VT_I4) specified by a key. |
| GetSignedLargeIntegerValue | Retrieves a LONGLONG value (type VT_I8) specified by a key. |
| GetStringValue | Retrieves a string value (type VT_LPWSTR) specified by a key. |
| GetUnsignedIntegerValue | Retrieves a ULONG value (type VT_UI4) specified by a key. |
| GetUnsignedLargeIntegerValue | Retrieves a ULONGLONG value (type VT_UI8) specified by a key. |
| GetValue | Retrieves a PROPVARIANT value specified by a key. |
| RemoveValue | Removes an item from the collection. |
| SetBoolValue | Adds a new Boolean value (type VT_BOOL) or overwrites an existing one. |
| SetBufferValue | Adds a new BYTE* value (type VT_VECTOR | VT_UI1) or overwrites an existing one. |
| SetErrorValue | Adds a new HRESULT value (type VT_ERROR) or overwrites an existing one. |
| SetFloatValue | Adds a new FLOAT value (type VT_R4) or overwrites an existing one. |
| SetGuidValue | Adds a new GUID value (type VT_CLSID) or overwrites an existing one. |
| SetIPortableDeviceKeyCollectionValue | Adds a new IPortableDeviceKeyCollectionValue value (type VT_UNKNOWN) or overwrites an existing one. |
| SetIPortableDevicePropVariantCollectionValue | Adds a new IPortableDevicePropVariantCollection value (type VT_UNKNOWN) or overwrites an existing one. |
| SetIPortableDeviceValuesCollectionValue | Adds a new IPortableDeviceValuesCollection value (type VT_UNKNOWN) or overwrites an existing one. |
| SetIPortableDeviceValuesValue | Adds a new IPortableDeviceValues value (type VT_UNKNOWN) or overwrites an existing one. |
| SetIUnknownValue | Adds a new IUnknown value (type VT_UNKNOWN) or overwrites an existing one. |
| SetKeyValue | Adds a new PROPERTYKEY (type VT_UNKNOWN) value or overwrites an existing one. |
| SetSignedIntegerValue | Adds a new LONG value (type VT_I4) or overwrites an existing one. |
| SetSignedLargeIntegerValue | Adds a new LONGLONG value (type VT_I8) or overwrites an existing one. |
| SetStringValue | Adds a new string value (type VT_LPWSTR) or overwrites an existing one. |
| SetUnsignedIntegerValue | Adds a new ULONG value (type VT_UI4) or overwrites an existing one. |
| SetUnsignedLargeIntegerValue | Adds a new ULONGLONG value (type VT_UI8) or overwrites an existing one. |
| SetValue | Adds a new PROPVARIANT value or overwrites an existing one. |
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|