IPropertyStorage ::ReadMultiple, méthode (propidl.h)

Article
03/01/2024

La méthode ReadMultiple lit les propriétés spécifiées à partir du jeu de propriétés actuel.

Syntaxe

HRESULT ReadMultiple(
  [in]  ULONG             cpspec,
  [in]  const PROPSPEC [] rgpspec,
  [out] PROPVARIANT []    rgpropvar
);

Paramètres

[in] cpspec

Nombre numérique de propriétés à spécifier dans le tableau rgpspec . La valeur de ce paramètre peut être définie sur zéro ; toutefois, cela va à l’inverse de l’objectif de la méthode, car aucune propriété n’est ainsi lue, quelles que soient les valeurs définies dans rgpspec.

[in] rgpspec

Un tableau de structures PROPSPEC spécifie les propriétés lues. Les propriétés peuvent être spécifiées par un ID de propriété ou par un nom de chaîne facultatif. Il n’est pas nécessaire de spécifier des propriétés dans un ordre particulier dans le tableau. Le tableau peut contenir des propriétés en double, ce qui entraîne des valeurs de propriété en double au retour pour les propriétés simples. Les propriétés non simples doivent renvoyer l’accès refusé lors d’une deuxième tentative d’ouverture. Le tableau peut contenir un mélange d’ID de propriété et d’ID de chaîne.

[out] rgpropvar

Tableau alloué par l’appelant d’une structure PROPVARIANT qui, en retour, contient les valeurs des propriétés spécifiées par les éléments correspondants dans le tableau rgpspec . Le tableau doit être au moins suffisamment grand pour contenir les valeurs du paramètre cpspec de la structure PROPVARIANT . Le paramètre cpspec spécifie le nombre de propriétés définies dans le tableau. L’appelant n’est pas obligé d’initialiser ces valeurs de structure PROPVARIANT dans un ordre spécifique. Toutefois, l’implémentation doit remplir correctement tous les membres au retour. S’il n’existe aucune autre valeur appropriée, l’implémentation doit définir le membre vt de chaque structure PROPVARIANT sur VT_EMPTY.

Valeur retournée

Cette méthode prend en charge la valeur de retour standard E_UNEXPECTED, ainsi que les éléments suivants :

Cette fonction peut également retourner des erreurs de système de fichiers ou des erreurs Win32 encapsulées dans un type de données HRESULT . Pour plus d’informations, consultez Stratégies de gestion des erreurs.

Pour plus d’informations, consultez Considérations relatives au stockage des propriétés.

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