Partager via


Interface IEnumSTATPROPSTG (propidlbase.h)

L’interface IEnumSTATPROPSTG itère au sein d’un tableau de structures STATPROPSTG . Les structures STATPROPSTG contiennent des données statistiques sur les propriétés d’un jeu de propriétés. IEnumSTATPROPSTG a les mêmes méthodes que toutes les interfaces d’énumérateur : Next, Skip, Reset et Clone.

L’implémentation définit l’ordre dans lequel les propriétés du jeu sont énumérées. Les propriétés présentes lors de la création de l’énumérateur et qui ne sont pas supprimées pendant l’énumération ne seront énumérées qu’une seule fois. Les propriétés ajoutées ou supprimées pendant que l’énumération est en cours peuvent ou non être énumérées, mais ne seront jamais énumérées plus d’une fois.

Les identificateurs de propriétés réservées, les propriétés dont l’ID de propriété est 0 (dictionnaire), 1 (indicateur de page de codes) ou supérieur ou égal à 0x80000000 ne sont pas énumérés.

L’énumération d’une propriété nonsimple n’indique pas nécessairement que la propriété peut être lue correctement par le biais d’un appel à IPropertyStorage ::ReadMultiple. Cela est dû au fait que la surcharge de performances liée à la vérification de l’existence du flux indirect ou du stockage est prohibitive pendant l’énumération de propriété.

Héritage

L’interface IEnumSTATPROPSTG hérite de l’interface IUnknown. IEnumSTATPROPSTG a également les types de membres suivants :

Méthodes

L’interface IEnumSTATPROPSTG utilise ces méthodes.

 
IEnumSTATPROPSTG ::Clone

La méthode IEnumSTATPROPSTG ::Clone crée un énumérateur qui contient le même état d’énumération que l’énumérateur de structure STATPROPSTG actuel.
IEnumSTATPROPSTG ::Next

La méthode IEnumSTATPROPSTG ::Next récupère un nombre spécifié de structures STATPROPSTG, qui suivent ensuite dans la séquence d’énumération.
IEnumSTATPROPSTG ::Reset

La méthode IEnumSTATPROPSTG ::Reset réinitialise la séquence d’énumération au début du tableau de structure STATPROPSTG.
IEnumSTATPROPSTG ::Skip

La méthode IEnumSTATPROPSTG ::Skip ignore le nombre spécifié de structures STATPROPSTG dans la séquence d’énumération.

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 propidlbase.h (include Propidl.h)

Voir aussi

Exemple EnumAll

IPropertyStorage ::Enum