IPortableDeviceValues-Schnittstelle (portabledevicetypes.h)

Die IPortableDeviceValues-Schnittstelle enthält eine Auflistung von PROPERTYKEY/PROPVARIANT-Paaren . Die Werte in der Auflistung müssen nicht gleich VARTYPE 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 hinzufügen oder abrufen, indem Sie die generischen Methoden SetValue und GetValue verwenden, 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. Das 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 Elemente zugeordnet wurde.

Diese Schnittstelle kann von einer Methode abgerufen werden, oder, wenn ein neues Objekt erforderlich ist, CoCreate mit CLSID_PortableDeviceValues aufrufen.

Vererbung

Die IPortableDeviceValues-Schnittstelle erbt von der IUnknown-Schnittstelle . IPortableDeviceValues verfügt auch über folgende Membertypen:

Methoden

Die IPortableDeviceValues-Schnittstelle verfügt über diese Methoden.

IPortableDeviceValues::Clear Erfahren Sie, wie diese Methode alle Elemente aus der Auflistung löscht.
IPortableDeviceValues::CopyValuesFromPropertyStore Kopiert den Inhalt eines IPropertyStore in die Auflistung.
IPortableDeviceValues::CopyValuesToPropertyStore Kopiert alle Werte aus einer Auflistung in eine IPropertyStore-Schnittstelle.
IPortableDeviceValues::GetAt Ruft einen Wert aus der Auflistung durch einen nullbasierten Index ab.
IPortableDeviceValues::GetBoolValue Ruft einen booleschen Wert (Typ VT_BOOL) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetBufferValue Die GetBufferValue-Schnittstelle ruft einen Bytearraywert (Typ VT_VECTOR oder VT_UI1) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetCount Ruft die Anzahl der Elemente in der Auflistung ab.
IPortableDeviceValues::GetErrorValue Ruft einen HRESULT-Wert (Typ VT_ERROR) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetFloatValue Die GetFloatValue-Methode ruft einen FLOAT-Wert (Typ VT_R4) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetGuidValue Ruft einen GUID-Wert (Typ VT_CLSID) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetIPortableDeviceKeyCollectionValue Ruft einen IPortableDeviceKeyCollection-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetIPortableDevicePropVariantCollectionValue Ruft einen IPortableDevicePropVariantCollection-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetIPortableDeviceValuesCollectionValue Ruft einen IPortableDeviceValuesCollection-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetIPortableDeviceValuesValueValue Ruft einen IPortableDeviceValues-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetIUnknownValue Ruft einen IUnknown-Schnittstellenwert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetKeyValue Ruft einen PROPERTYKEY-Wert (Typ VT_UNKNOWN) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetSignedIntegerValue Ruft einen LONG-Wert (Typ VT_I4) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetSignedLargeIntegerValue Ruft einen LONGLONG-Wert (Typ VT_I8) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetStringValue Ruft einen Zeichenfolgenwert (Typ VT_LPWSTR) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetUnsignedIntegerValue Ruft einen ULONG-Wert (Typ VT_UI4) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetUnsignedLargeIntegerValue Ruft einen ULONGLONGLONG-Wert (Typ VT_UI8) ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::GetValue Die GetValue-Schnittstelle ruft einen PROPVARIANT-Wert ab, der durch einen Schlüssel angegeben wird.
IPortableDeviceValues::RemoveValue Die RemoveValue-Methode entfernt ein Element aus der Auflistung.
IPortableDeviceValues::SetBoolValue Fügt einen neuen booleschen Wert hinzu (Typ VT_BOOL) oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetBufferValue Fügt einen neuen BYTE*-Wert hinzu (Typ VT_VECTOR oder VT_UI1) oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetErrorValue Fügt einen neuen HRESULT-Wert (Typ VT_ERROR) hinzu oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetFloatValue Fügt einen neuen FLOAT-Wert (Typ VT_R4) hinzu oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetGuidValue Fügt einen neuen GUID-Wert (Typ VT_CLSID) hinzu oder überschreibt einen vorhandenen GUID-Wert.
IPortableDeviceValues::SetIPortableDeviceKeyCollectionValue Fügt einen neuen SetIPortableDeviceKeyCollectionValue-Wert hinzu (Typ VT_UNKNOWN) oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetIPortableDevicePropVariantCollectionValue Fügt einen neuen IPortableDevicePropVariantCollection-Wert (Typ VT_UNKNOWN) hinzu oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetIPortableDeviceValuesCollectionValue Fügt einen neuen IPortableDeviceValuesCollection-Wert (Typ VT_UNKNOWN) hinzu oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetIPortableDeviceValuesValueValue Fügt einen neuen IPortableDeviceValues-Wert (Typ VT_UNKNOWN) hinzu oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetIUnknownValue Fügt einen neuen IUnknown-Wert hinzu (Typ VT_UNKNOWN) oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetKeyValue Fügt einen neuen REFPROPERTYKEY-Wert hinzu (Typ VT_UNKNOWN) oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetSignedIntegerValue Fügt einen neuen LONG-Wert (Typ VT_I4) hinzu oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetSignedLargeIntegerValue Fügt einen neuen LONGLONG-Wert (Typ VT_I8) hinzu oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetStringValue Fügt einen neuen Zeichenfolgenwert hinzu (Typ VT_LPWSTR) oder überschreibt einen vorhandenen.
IPortableDeviceValues::SetUnsignedIntegerValue Fügt einen neuen ULONG-Wert hinzu (Typ VT_UI4) oder überschreibt einen vorhandenen.
IPortableDeviceValues::SetUnsignedLargeIntegerValue Fügt einen neuen ULONGLONGLONG-Wert (Typ VT_UI8) hinzu oder überschreibt einen vorhandenen Wert.
IPortableDeviceValues::SetValue Fügt einen neuen Wert hinzu oder überschreibt einen vorhandenen Wert.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledevicetypes.h

Weitere Informationen

Sammlungsschnittstellen