Méthode IPropertyStorage ::ReadPropertyNames (propidl.h)
La méthode ReadPropertyNames récupère tous les noms de chaîne existants pour les ID de propriété spécifiés.
Syntaxe
HRESULT ReadPropertyNames(
[in] ULONG cpropid,
[in] const PROPID [] rgpropid,
[in, out] LPOLESTR [] rglpwstrName
);
Paramètres
[in] cpropid
Nombre d’éléments à l’entrée du rgpropid de tableau. La valeur de ce paramètre peut être définie sur zéro, mais cela va à l’encontre de l’objectif de cette méthode, car aucun nom de propriété n’est ainsi lu.
[in] rgpropid
Tableau d’ID de propriété pour lesquels les noms doivent être récupérés.
[in, out] rglpwstrName
Tableau alloué par l’appelant de taille cpropid de membres LPWSTR . Au retour, l’implémentation remplit ce tableau. Une entrée donnée contient le nom de chaîne correspondant d’un ID de propriété ou peut être vide si l’ID de propriété n’a pas de noms de chaîne.
Chaque membre LPWSTR du tableau doit être libéré à l’aide de la fonction CoTaskMemFree .
Valeur retournée
Cette méthode prend en charge la valeur de retour standard E_UNEXPECTED, en plus des éléments suivants :
Remarques
Pour chaque ID de propriété dans la liste des ID de propriété fournis dans le tableau rgpropid , ReadPropertyNames récupère le nom de chaîne correspondant, le cas échéant. Les noms de chaîne sont créés soit en spécifiant les noms dans les appels à IPropertyStorage ::WriteMultiple lors de la création de la propriété, soit par le biais d’un appel à IPropertyStorage ::WritePropertyNames. Dans les deux cas, le nom de la chaîne est facultatif, mais toutes les propriétés doivent avoir un ID de propriété.
Les noms de chaîne mappés aux ID de propriété doivent être uniques dans le jeu.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | propidl.h (inclure Objbase.h, Propidlbase.h) |
| Bibliothèque | Uuid.lib |
| DLL | Ole32.dll |