Partager via


Méthode IPortableDeviceValues::GetValue

La méthode GetValue récupère une valeur PROPVARIANT spécifiée par une clé.

Syntaxe

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

Paramètres

clé [in]

Clé REFPROPERTYKEY qui spécifie l’élément à récupérer.

pValue [out]

Pointeur vers la valeur PROPVARIANT récupérée. L’appelant doit libérer la mémoire en appelant PropVariantClear lorsqu’il l’a terminé.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
S_OK
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
La propriété spécifiée par la clé ne figure pas dans la collection.

Notes

Lorsque le VARTYPE pour pValue est VT_VECTOR ou VT_UI1, la récupération d’une mémoire tampon NULL ou de taille nulle n’est pas prise en charge. Par exemple, ni pValue.caub.pElems = NULL ni pValue.caub.cElems = 0 ne sont autorisés.

Cette méthode peut être utilisée pour récupérer une valeur de n’importe quel type à partir de la collection. Toutefois, si vous connaissez le type de valeur à l’avance, utilisez l’une des méthodes de récupération spécialisées de cette interface pour éviter la surcharge liée à l’utilisation directe des valeurs PROPVARIANT.

Spécifications

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

Voir aussi

IPortableDeviceValues, interface

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue