Méthode IPropertyStorage::ReadPropertyNames (propidlbase.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 en entrée du rgpropid de tableau. La valeur de ce paramètre peut être définie sur zéro, mais cela va à l’échec 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é dont les noms doivent être récupérés.
[in, out] rglpwstrName
Tableau alloué à 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 aucun nom 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 :
Notes
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 en spécifiant les noms dans les appels à IPropertyStorage::WriteMultiple lors de la création de la propriété, ou via un appel à IPropertyStorage::WritePropertyNames. Dans les deux cas, le nom de 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 au sein de l’ensemble.
Spécifications
| 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 | propidlbase.h (inclure Objbase.h, Propidlbase.h) |
| Bibliothèque | Uuid.lib |
| DLL | Ole32.dll |