IDiaPropertyStorage::ReadMultiple

  • Article

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.

Voir aussi