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 |
|
| Bibliothèque |
|