Méthode IPropertyStorage ::ReadPropertyNames (propidl.h)

  • Article

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

Voir aussi

IPropertyStorage

IPropertyStorage ::WriteMultiple

IPropertyStorage ::WritePropertyNames