Freigeben über


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
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Siehe auch

Sammlungsschnittstellen