Méthode IPortableDeviceValues::GetBufferValue

La méthode GetBufferValue récupère une valeur de tableau d’octets (type VT_VECTOR | VT_UI1) spécifié par une clé.

Syntaxe

HRESULT GetBufferValue(
  [in]  REFPROPERTYKEY key,
  [out] BYTE           **ppValue,
  [out] DWORD          *pcbValue
);

clé [in]: Clé REFPROPERTYKEY qui spécifie l’élément à récupérer.
ppValue [out]: Pointeur vers la valeur BYTE* récupérée. L’appelant est responsable de libérer la mémoire en appelant CoTaskMemFree.
pcbValue [out]: Pointeur vers la taille de ppValue, en octets.

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
DISP_E_TYPEMISMATCH	La propriété spécifiée par clé n’est pas un type BYTE*.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	La propriété spécifiée par la clé ne figure pas dans la collection.

La récupération d’une mémoire tampon NULL ou d’une mémoire tampon de taille nulle n’est pas prise en charge.

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