Interfaccia IPortableDeviceValues
L'interfaccia IPortableDeviceValues contiene una raccolta di coppie PROPERTYKEYPROPVARIANT/. I valori della raccolta non devono essere lo stesso VARTYPE.
I valori vengono archiviati come coppie chiave-valore; ogni chiave deve essere univoca nella raccolta. I client possono cercare elementi in base a PROPERTYKEY o indice in base zero. I valori dei dati vengono archiviati come strutture PROPVARIANT . È possibile aggiungere o recuperare valori di qualsiasi tipo usando i metodi generici SetValue e GetValue oppure aggiungere elementi usando il metodo specifico per il tipo di dati aggiunto.
I metodi Get... richiedono al chiamante di rilasciare i valori recuperati in modo appropriato. I metodi Set... copiano il valore nella raccolta.
Quando viene rilasciata un'interfaccia IPortableDeviceValues , chiama Clear, che libera la memoria allocata per tutti i membri in modo appropriato.
Questa interfaccia può essere recuperata da un metodo o, se è necessario un nuovo oggetto, chiamare CoCreate con CLSID_PortableDeviceValues.
Membri
L'interfaccia IPortableDeviceValues eredita dall'interfaccia IUnknown . IPortableDeviceValues include anche questi tipi di membri:
Metodi
L'interfaccia IPortableDeviceValues include questi metodi.
| Metodo | Descrizione |
|---|---|
| Cancella | Elimina tutti gli elementi dalla raccolta. |
| CopyValuesFromPropertyStore | Copia il contenuto di un archivio IProperty nell'insieme. |
| CopyValuesToPropertyStore | Copia tutti i valori da una raccolta in un'interfaccia IPropertyStore . |
| GetAt | Recupera un valore dalla raccolta usando l'indice in base zero fornito. |
| GetBoolValue | Recupera un valore BOOL (tipo VT_BOOL) specificato da una chiave. |
| GetBufferValue | Recupera un valore di matrice di byte (tipo VT_VECTOR | VT_UI1) specificato da una chiave. |
| GetCount | Recupera il numero di elementi nella raccolta. |
| GetErrorValue | Recupera un valore HRESULT (tipo VT_ERROR) specificato da una chiave. |
| GetFloatValue | Recupera un valore FLOAT (tipo VT_R4) specificato da una chiave. |
| GetGuidValue | Recupera un valore GUID (tipo VT_CLSID) specificato da una chiave. |
| GetIPortableDeviceKeyCollectionValue | Recupera un valore IPortableDeviceKeyCollection (tipo VT_UNKNOWN) specificato da una chiave. |
| GetIPortableDevicePropVariantCollectionValue | Recupera un valore IPortableDevicePropVariantCollection (tipo VT_UNKNOWN) specificato da una chiave. |
| GetIPortableDeviceValuesCollectionValue | Recupera un valore IPortableDeviceValuesCollection (tipo VT_UNKNOWN) specificato da una chiave. |
| GetIPortableDeviceValuesValue | Recupera un valore IPortableDeviceValues (tipo VT_UNKNOWN) specificato da una chiave. |
| GetIUnknownValue | Recupera un valore dell'interfaccia IUnknown (tipo VT_UNKNOWN) specificato da una chiave. |
| GetKeyValue | Recupera un valore PROPERTYKEY specificato da una chiave. |
| GetSignedIntegerValue | Recupera un valore LONG (tipo VT_I4) specificato da una chiave. |
| GetSignedLargeIntegerValue | Recupera un valore LONGLONG (tipo VT_I8) specificato da una chiave. |
| GetStringValue | Recupera un valore stringa (tipo VT_LPWSTR) specificato da una chiave. |
| GetUnsignedIntegerValue | Recupera un valore ULONG (tipo VT_UI4) specificato da una chiave. |
| GetUnsignedLargeIntegerValue | Recupera un valore ULONGLONG (tipo VT_UI8) specificato da una chiave. |
| Getvalue | Recupera un valore PROPVARIANT specificato da una chiave. |
| RemoveValue | Rimuove un elemento dalla raccolta. |
| SetBoolValue | Aggiunge un nuovo valore booleano (tipo VT_BOOL) o sovrascrive uno esistente. |
| SetBufferValue | Aggiunge un nuovo valore BYTE* (tipo VT_VECTOR | VT_UI1) o sovrascrive uno esistente. |
| SetErrorValue | Aggiunge un nuovo valore HRESULT (tipo VT_ERROR) o sovrascrive uno esistente. |
| SetFloatValue | Aggiunge un nuovo valore FLOAT (tipo VT_R4) o sovrascrive uno esistente. |
| SetGuidValue | Aggiunge un nuovo valore GUID (tipo VT_CLSID) o sovrascrive uno esistente. |
| SetIPortableDeviceKeyCollectionValue | Aggiunge un nuovo valore IPortableDeviceKeyCollectionValue (tipo VT_UNKNOWN) o sovrascrive uno esistente. |
| SetIPortableDevicePropVariantCollectionValue | Aggiunge un nuovo valore IPortableDevicePropVariantCollection (tipo VT_UNKNOWN) o sovrascrive uno esistente. |
| SetIPortableDeviceValuesCollectionValue | Aggiunge un nuovo valore IPortableDeviceValuesCollection (tipo VT_UNKNOWN) o sovrascrive uno esistente. |
| SetIPortableDeviceValuesValue | Aggiunge un nuovo valore IPortableDeviceValues (tipo VT_UNKNOWN) o sovrascrive uno esistente. |
| SetIUnknownValue | Aggiunge un nuovo valore IUnknown (tipo VT_UNKNOWN) o sovrascrive uno esistente. |
| SetKeyValue | Aggiunge un nuovo valore PROPERTYKEY (tipo VT_UNKNOWN) o sovrascrive uno esistente. |
| SetSignedIntegerValue | Aggiunge un nuovo valore LONG (tipo VT_I4) o sovrascrive uno esistente. |
| SetSignedLargeIntegerValue | Aggiunge un nuovo valore LONGLONG (tipo VT_I8) o sovrascrive uno esistente. |
| SetStringValue | Aggiunge un nuovo valore stringa (tipo VT_LPWSTR) o sovrascrive uno esistente. |
| SetUnsignedIntegerValue | Aggiunge un nuovo valore ULONG (tipo VT_UI4) o sovrascrive uno esistente. |
| SetUnsignedLargeIntegerValue | Aggiunge un nuovo valore ULONGLONG (tipo VT_UI8) o sovrascrive uno esistente. |
| SetValue | Aggiunge un nuovo valore PROPVARIANT o ne sovrascrive uno esistente. |
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|