Partager via


Interface IPortableDeviceValues

L’interface IPortableDeviceValues contient une collection de paires PROPERTYKEY/PROPVARIANT . Les valeurs de la collection n’ont pas besoin d’être le même VARTYPE.

Les valeurs sont stockées sous forme de paires clé-valeur ; chaque clé doit être unique dans la collection. Les clients peuvent rechercher des éléments par PROPERTYKEY ou index de base zéro. Les valeurs de données sont stockées en tant que structures PROPVARIANT . Vous pouvez ajouter ou récupérer des valeurs de n’importe quel type à l’aide des méthodes génériques SetValue et GetValue, ou vous ajoutez des éléments à l’aide de la méthode spécifique au type de données ajouté.

Les méthodes Get... nécessitent que l’appelant libère correctement toutes les valeurs récupérées. Les méthodes Set... copient la valeur dans la collection.

Lorsqu’une interface IPortableDeviceValues est publiée, elle appelle Clear, ce qui libère la mémoire allouée à tous ses membres de manière appropriée.

Cette interface peut être récupérée à partir d’une méthode ou, si un nouvel objet est nécessaire, appeler CoCreate avec CLSID_PortableDeviceValues.

Membres

L’interface IPortableDeviceValues hérite de l’interface IUnknown. IPortableDeviceValues a également les types de membres suivants :

Méthodes

L’interface IPortableDeviceValues a ces méthodes.

Méthode Description
Effacer Supprime tous les éléments de la collection.
CopyValuesFromPropertyStore Copie le contenu d’un IPropertyStore dans la collection.
CopyValuesToPropertyStore Copie toutes les valeurs d’une collection dans une interface IPropertyStore .
GetAt Récupère une valeur de la collection à l’aide de l’index de base zéro fourni.
GetBoolValue Récupère une valeur BOOL (type VT_BOOL) spécifiée par une clé.
GetBufferValue Récupère une valeur de tableau d’octets (type VT_VECTOR | VT_UI1) spécifié par une clé.
GetCount Récupère le nombre d’éléments de la collection.
GetErrorValue Récupère une valeur HRESULT (type VT_ERROR) spécifiée par une clé.
GetFloatValue Récupère une valeur FLOAT (type VT_R4) spécifiée par une clé.
GetGuidValue Récupère une valeur GUID (type VT_CLSID) spécifiée par une clé.
GetIPortableDeviceKeyCollectionValue Récupère une valeur IPortableDeviceKeyCollection (type VT_UNKNOWN) spécifiée par une clé.
GetIPortableDevicePropVariantCollectionValue Récupère une valeur IPortableDevicePropVariantCollection (type VT_UNKNOWN) spécifiée par une clé.
GetIPortableDeviceValuesCollectionValue Récupère une valeur IPortableDeviceValuesCollection (type VT_UNKNOWN) spécifiée par une clé.
GetIPortableDeviceValuesValue Récupère une valeur IPortableDeviceValues (type VT_UNKNOWN) spécifiée par une clé.
GetIUnknownValue Récupère une valeur d’interface IUnknown (type VT_UNKNOWN) spécifiée par une clé.
GetKeyValue Récupère une valeur PROPERTYKEY spécifiée par une clé.
GetSignedIntegerValue Récupère une valeur LONG (type VT_I4) spécifiée par une clé.
GetSignedLargeIntegerValue Récupère une valeur LONGLONG (type VT_I8) spécifiée par une clé.
GetStringValue Récupère une valeur de chaîne (type VT_LPWSTR) spécifiée par une clé.
GetUnsignedIntegerValue Récupère une valeur ULONG (type VT_UI4) spécifiée par une clé.
GetUnsignedLargeIntegerValue Récupère une valeur ULONGLONG (type VT_UI8) spécifiée par une clé.
GetValue Récupère une valeur PROPVARIANT spécifiée par une clé.
RemoveValue Supprime un élément de la collection.
SetBoolValue Ajoute une nouvelle valeur booléenne (type VT_BOOL) ou remplace une valeur existante.
SetBufferValue Ajoute une nouvelle valeur BYTE* (type VT_VECTOR | VT_UI1) ou remplace un existant.
SetErrorValue Ajoute une nouvelle valeur HRESULT (type VT_ERROR) ou remplace une valeur existante.
SetFloatValue Ajoute une nouvelle valeur FLOAT (type VT_R4) ou remplace une valeur existante.
SetGuidValue Ajoute une nouvelle valeur GUID (type VT_CLSID) ou remplace une valeur existante.
SetIPortableDeviceKeyCollectionValue Ajoute une nouvelle valeur IPortableDeviceKeyCollectionValue (type VT_UNKNOWN) ou remplace une valeur existante.
SetIPortableDevicePropVariantCollectionValue Ajoute une nouvelle valeur IPortableDevicePropVariantCollection (type VT_UNKNOWN) ou remplace une valeur existante.
SetIPortableDeviceValuesCollectionValue Ajoute une nouvelle valeur IPortableDeviceValuesCollection (type VT_UNKNOWN) ou remplace une valeur existante.
SetIPortableDeviceValuesValue Ajoute une nouvelle valeur IPortableDeviceValues (type VT_UNKNOWN) ou remplace une valeur existante.
SetIUnknownValue Ajoute une nouvelle valeur IUnknown (type VT_UNKNOWN) ou remplace une valeur existante.
SetKeyValue Ajoute une nouvelle valeur PROPERTYKEY (type VT_UNKNOWN) ou remplace une valeur existante.
SetSignedIntegerValue Ajoute une nouvelle valeur LONG (type VT_I4) ou remplace une valeur existante.
SetSignedLargeIntegerValue Ajoute une nouvelle valeur LONGLONG (type VT_I8) ou remplace une valeur existante.
SetStringValue Ajoute une nouvelle valeur de chaîne (type VT_LPWSTR) ou remplace une valeur existante.
SetUnsignedIntegerValue Ajoute une nouvelle valeur ULONG (type VT_UI4) ou remplace une valeur existante.
SetUnsignedLargeIntegerValue Ajoute une nouvelle valeur ULONGLONG (type VT_UI8) ou remplace une valeur existante.
SetValue Ajoute une nouvelle valeur PROPVARIANT ou remplace une valeur existante.

Spécifications

Condition requise Valeur
En-tête
PortableDeviceTypes.h
Bibliothèque
PortableDeviceGUIDs.lib

Voir aussi

Collection Interfaces