IPortableDeviceValues-Schnittstelle
Die IPortableDeviceValues-Schnittstelle enthält eine Auflistung von PROPERTYKEY/PROPVARIANT-Paaren . Die Werte in der Auflistung müssen nicht mit VARTYPE identisch sein.
Werte werden als Schlüssel-Wert-Paare gespeichert. Jeder Schlüssel muss in der Auflistung eindeutig sein. Clients können nach Elementen nach PROPERTYKEY oder nullbasiertem Index suchen. Datenwerte werden als PROPVARIANT-Strukturen gespeichert. Sie können Werte eines beliebigen Typs mit den generischen Methoden SetValue und GetValue hinzufügen oder abrufen, oder Sie können Elemente mithilfe der Methode hinzufügen, die für den Typ der hinzugefügten Daten spezifisch ist.
Die Get...- Methoden erfordern, dass der Aufrufer alle abgerufenen Werte entsprechend freigibt. Die Set...- Methoden kopieren den Wert in die Auflistung.
Wenn eine IPortableDeviceValues-Schnittstelle freigegeben wird, ruft sie Clear auf, wodurch der Speicher freigegeben wird, der für alle zugehörigen Member zugewiesen wurde.
Diese Schnittstelle kann von einer Methode abgerufen werden oder, wenn ein neues Objekt erforderlich ist, CoCreate mit CLSID_PortableDeviceValues aufrufen.
Member
Die IPortableDeviceValues-Schnittstelle erbt von der IUnknown-Schnittstelle . IPortableDeviceValues verfügt auch über folgende Arten von Membern:
Methoden
Die IPortableDeviceValues-Schnittstelle verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Clear | Löscht alle Elemente aus der Auflistung. |
| CopyValuesFromPropertyStore | Kopiert den Inhalt eines IPropertyStores in die Auflistung. |
| CopyValuesToPropertyStore | Kopiert alle Werte aus einer Auflistung in eine IPropertyStore-Schnittstelle . |
| GetAt | Ruft einen Wert aus der Auflistung unter Verwendung des angegebenen nullbasierten Index ab. |
| GetBoolValue | Ruft einen BOOL-Wert (Typ VT_BOOL) ab, der durch einen Schlüssel angegeben wird. |
| GetBufferValue | Ruft einen Bytearraywert ab (Typ VT_VECTOR | VT_UI1) durch einen Schlüssel angegeben. |
| GetCount | Ruft die Anzahl der Elemente in der Auflistung ab. |
| GetErrorValue | Ruft einen durch einen Schlüssel angegebenen HRESULT-Wert (Typ VT_ERROR) ab. |
| GetFloatValue | Ruft einen FLOAT-Wert (Typ VT_R4) ab, der durch einen Schlüssel angegeben wird. |
| GetGuidValue | Ruft einen GUID-Wert (Typ VT_CLSID) ab, der durch einen Schlüssel angegeben wird. |
| GetIPortableDeviceKeyCollectionValue | Ruft einen IPortableDeviceKeyCollection-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird. |
| GetIPortableDevicePropVariantCollectionValue | Ruft einen IPortableDevicePropVariantCollection-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird. |
| GetIPortableDeviceValuesCollectionValue | Ruft einen IPortableDeviceValuesCollection-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird. |
| GetIPortableDeviceValuesValueValue | Ruft einen IPortableDeviceValues-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird. |
| GetIUnknownValue | Ruft einen IUnknown-Schnittstellenwert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird. |
| GetKeyValue | Ruft einen PROPERTYKEY-Wert ab, der durch einen Schlüssel angegeben wird. |
| GetSignedIntegerValue | Ruft einen LONG-Wert (Typ VT_I4) ab, der durch einen Schlüssel angegeben wird. |
| GetSignedLargeIntegerValue | Ruft einen LONGLONG-Wert (Typ VT_I8) ab, der durch einen Schlüssel angegeben wird. |
| GetStringValue | Ruft einen Zeichenfolgenwert (Typ VT_LPWSTR) ab, der durch einen Schlüssel angegeben wird. |
| GetUnsignedIntegerValue | Ruft einen ULONG-Wert (Typ VT_UI4) ab, der durch einen Schlüssel angegeben wird. |
| GetUnsignedLargeIntegerValue | Ruft einen ULONGLONGLONG-Wert (Typ VT_UI8) ab, der durch einen Schlüssel angegeben wird. |
| Getvalue | Ruft einen PROPVARIANT-Wert ab, der durch einen Schlüssel angegeben wird. |
| RemoveValue | Entfernt ein Element aus der Auflistung. |
| SetBoolValue | Fügt einen neuen booleschen Wert hinzu (Typ VT_BOOL) oder überschreibt einen vorhandenen Wert. |
| SetBufferValue | Fügt einen neuen BYTE*-Wert hinzu (Typ VT_VECTOR | VT_UI1) oder überschreibt eine vorhandene. |
| SetErrorValue | Fügt einen neuen HRESULT-Wert hinzu (Typ VT_ERROR) oder überschreibt einen vorhandenen Wert. |
| SetFloatValue | Fügt einen neuen FLOAT-Wert hinzu (Typ VT_R4) oder überschreibt einen vorhandenen Wert. |
| SetGuidValue | Fügt einen neuen GUID-Wert hinzu (Typ VT_CLSID) oder überschreibt einen vorhandenen GUID-Wert. |
| SetIPortableDeviceKeyCollectionValue | Fügt einen neuen IPortableDeviceKeyCollectionValue-Wert hinzu (Typ VT_UNKNOWN) oder überschreibt einen vorhandenen Wert. |
| SetIPortableDevicePropVariantCollectionValue | Fügt einen neuen IPortableDevicePropVariantCollection-Wert hinzu (Typ VT_UNKNOWN) oder überschreibt einen vorhandenen Wert. |
| SetIPortableDeviceValuesCollectionValue | Fügt einen neuen IPortableDeviceValuesCollection-Wert (Typ VT_UNKNOWN) hinzu oder überschreibt einen vorhandenen Wert. |
| SetIPortableDeviceValuesValueValue | Fügt einen neuen IPortableDeviceValues-Wert hinzu (Typ VT_UNKNOWN) oder überschreibt einen vorhandenen Wert. |
| SetIUnknownValue | Fügt einen neuen IUnknown-Wert hinzu (Typ VT_UNKNOWN) oder überschreibt einen vorhandenen Wert. |
| SetKeyValue | Fügt einen neuen PROPERTYKEY-Wert (Typ VT_UNKNOWN) hinzu oder überschreibt einen vorhandenen Wert. |
| SetSignedIntegerValue | Fügt einen neuen LONG-Wert hinzu (Typ VT_I4) oder überschreibt einen vorhandenen Wert. |
| SetSignedLargeIntegerValue | Fügt einen neuen LONGLONG-Wert hinzu (Typ VT_I8) oder überschreibt einen vorhandenen Wert. |
| SetStringValue | Fügt einen neuen Zeichenfolgenwert hinzu (Typ VT_LPWSTR) oder überschreibt einen vorhandenen Zeichenfolgenwert. |
| SetUnsignedIntegerValue | Fügt einen neuen ULONG-Wert hinzu (Typ VT_UI4) oder überschreibt einen vorhandenen Wert. |
| SetUnsignedLargeIntegerValue | Fügt einen neuen ULONGLONG-Wert hinzu (Typ VT_UI8) oder überschreibt einen vorhandenen Wert. |
| SetValue | Fügt einen neuen PROPVARIANT-Wert hinzu oder überschreibt einen vorhandenen Wert. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|