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 |
|
| Biblioteca |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de