Compartilhar via


Interface IPortableDeviceValues

A interface IPortableDeviceValues contém uma coleção de pares PROPERTYKEYPROPVARIANT/. Os valores na coleção não precisam ser o mesmo VARTYPE.

Os valores são armazenados como pares chave-valor; cada chave deve ser exclusiva na coleção. Os clientes podem pesquisar itens por PROPERTYKEY ou índice baseado em zero. Os valores de dados são armazenados como estruturas PROPVARIANT . Você pode adicionar ou recuperar valores de qualquer tipo usando os métodos genéricos SetValue e GetValue ou adicionar itens usando o método específico ao tipo de dados adicionados.

Os métodos Get... exigem que o chamador libere os valores recuperados adequadamente. Os métodos Set... copiam o valor para a coleção.

Quando uma interface IPortableDeviceValues é lançada, ela chama Clear, que libera a memória alocada para todos os seus membros adequadamente.

Essa interface pode ser recuperada de um método ou, se um novo objeto for necessário, chame CoCreate com CLSID_PortableDeviceValues.

Membros

A interface IPortableDeviceValues herda da interface IUnknown . IPortableDeviceValues também tem esses tipos de membros:

Métodos

A interface IPortableDeviceValues tem esses métodos.

Método Descrição
Limpar Exclui todos os itens da coleção.
CopyValuesFromPropertyStore Copia o conteúdo de um IPropertyStore para a coleção.
CopyValuesToPropertyStore Copia todos os valores de uma coleção para uma interface IPropertyStore .
Getat Recupera um valor da coleção usando o índice baseado em zero fornecido.
GetBoolValue Recupera um valor BOOL (tipo VT_BOOL) especificado por uma chave.
GetBufferValue Recupera um valor de matriz de bytes (tipo VT_VECTOR | VT_UI1) especificado por uma chave.
GetCount Recupera o número de itens na coleção.
GetErrorValue Recupera um valor HRESULT (tipo VT_ERROR) especificado por uma chave.
GetFloatValue Recupera um valor FLOAT (tipo VT_R4) especificado por uma chave.
GetGuidValue Recupera um valor GUID (tipo VT_CLSID) especificado por uma chave.
GetIPortableDeviceKeyCollectionValue Recupera um valor IPortableDeviceKeyCollection (tipo VT_UNKNOWN) especificado por uma chave.
GetIPortableDevicePropVariantCollectionValue Recupera um valor IPortableDevicePropVariantCollection (tipo VT_UNKNOWN) especificado por uma chave.
GetIPortableDeviceValuesCollectionValue Recupera um valor IPortableDeviceValuesCollection (tipo VT_UNKNOWN) especificado por uma chave.
GetIPortableDeviceValuesValue Recupera um valor IPortableDeviceValues (tipo VT_UNKNOWN) especificado por uma chave.
GetIUnknownValue Recupera um valor de interface IUnknown (tipo VT_UNKNOWN) especificado por uma chave.
GetKeyValue Recupera um valor PROPERTYKEY especificado por uma chave.
GetSignedIntegerValue Recupera um valor LONG (tipo VT_I4) especificado por uma chave.
GetSignedLargeIntegerValue Recupera um valor LONGLONG (tipo VT_I8) especificado por uma chave.
GetStringValue Recupera um valor de cadeia de caracteres (tipo VT_LPWSTR) especificado por uma chave.
GetUnsignedIntegerValue Recupera um valor ULONG (tipo VT_UI4) especificado por uma chave.
GetUnsignedLargeIntegerValue Recupera um valor ULONGLONG (tipo VT_UI8) especificado por uma chave.
Getvalue Recupera um valor PROPVARIANT especificado por uma chave.
RemoveValue Remove um item da coleção.
SetBoolValue Adiciona um novo valor booliano (tipo VT_BOOL) ou substitui um existente.
SetBufferValue Adiciona um novo valor BYTE* (tipo VT_VECTOR | VT_UI1) ou substitui um existente.
SetErrorValue Adiciona um novo valor HRESULT (tipo VT_ERROR) ou substitui um existente.
SetFloatValue Adiciona um novo valor FLOAT (tipo VT_R4) ou substitui um existente.
SetGuidValue Adiciona um novo valor GUID (tipo VT_CLSID) ou substitui um existente.
SetIPortableDeviceKeyCollectionValue Adiciona um novo valor IPortableDeviceKeyCollectionValue (tipo VT_UNKNOWN) ou substitui um existente.
SetIPortableDevicePropVariantCollectionValue Adiciona um novo valor IPortableDevicePropVariantCollection (tipo VT_UNKNOWN) ou substitui um existente.
SetIPortableDeviceValuesCollectionValue Adiciona um novo valor IPortableDeviceValuesCollection (tipo VT_UNKNOWN) ou substitui um existente.
SetIPortableDeviceValuesValue Adiciona um novo valor IPortableDeviceValues (tipo VT_UNKNOWN) ou substitui um existente.
SetIUnknownValue Adiciona um novo valor IUnknown (tipo VT_UNKNOWN) ou substitui um existente.
SetKeyValue Adiciona um novo valor PROPERTYKEY (tipo VT_UNKNOWN) ou substitui um existente.
SetSignedIntegerValue Adiciona um novo valor LONG (tipo VT_I4) ou substitui um existente.
SetSignedLargeIntegerValue Adiciona um novo valor LONGLONG (tipo VT_I8) ou substitui um existente.
SetStringValue Adiciona um novo valor de cadeia de caracteres (tipo VT_LPWSTR) ou substitui um existente.
SetUnsignedIntegerValue Adiciona um novo valor ULONG (tipo VT_UI4) ou substitui um existente.
SetUnsignedLargeIntegerValue Adiciona um novo valor ULONGLONG (tipo VT_UI8) ou substitui um existente.
SetValue Adiciona um novo valor PROPVARIANT ou substitui um existente.

Requisitos

Requisito Valor
parâmetro
PortableDeviceTypes.h
Biblioteca
PortableDeviceGUIDs.lib

Confira também

Interfaces de coleção