IPortableDeviceValues::GetStringValue, méthode

La méthode GetStringValue récupère une valeur de chaîne (type VT_LPWSTR) spécifiée par une clé.

Syntaxe

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *pValue
);

key [in]: Clé REFPROPERTYKEY qui spécifie l’élément à récupérer.
pValue [out]: Pointeur vers la valeur LPWSTR récupérée. L’appelant est chargé d’appeler CoTaskMemFree pour libérer la mémoire.

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

Pour obtenir un exemple d’utilisation de cette méthode, consultez Récupération des événements de service pris en charge.

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