Méthode IPortableDeviceValues::GetValue

Article
06/13/2023

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

Partager via