IDiaPropertyStorage::ReadMultiple
Lit les propriétés spécifiées à partir du jeu de propriétés actuel.
Syntaxe
HRESULT ReadMultiple(
ULONG cpspec,
PROPSPEC const rgpspec,
PROPVARIANT rgvar
);
Paramètres
cpspec
[in] Nombre de propriétés spécifiées dans le tableau rgpspec
. Si la valeur est zéro, la méthode ne retourne aucune propriété, mais retourne S_OK
en tant que code de réussite.
rgpspec
[in] Tableau de propriétés à lire. 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 retourner un accès refusé lors d’une tentative de les ouvrir une deuxième fois. Le tableau peut contenir un mélange d’ID de propriété et d’ID de chaîne. Ce tableau doit avoir au moins un nombre de cpspec
valeurs de propriété.
rgvar
[in, out] Tableau de structures PROPVARIANT
(dans l’espace de noms Microsoft.VisualStudio.OLE.Interop) à remplir avec des valeurs pour chaque propriété. Le tableau doit avoir une taille d’au moins cpspec
éléments. L’appelant n’a pas besoin d’initialiser les valeurs du tableau.
Valeur renvoyée
En cas de réussite, retourne S_OK
. Retourne S_FALSE
si une ou plusieurs des propriétés sont introuvables. Sinon, retourne un code d’erreur.
Notes
Si une propriété est introuvable, l’entrée correspondante dans le tableau rgvar
contient un VARIANT
avec le type de VT_EMPTY
.