Partager via


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
);

Paramètres

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.

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
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.

Exemples

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

Spécifications

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

Voir aussi

IPortableDeviceValues, interface

IPortableDeviceValues::GetAt

IPortableDeviceValues::SetStringValue

Récupération des événements de service pris en charge

Récupération des formats de service pris en charge

Récupération des méthodes de service prises en charge