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

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