Partager via


implémentation de fichier IEnumSTATPROPSTG-Compound

L’implémentation de fichier composé de l’interface IEnumSTATPROPSTG est utilisée pour énumérer les propriétés, ce qui entraîne structures STATPROPSTG, qui contiennent des données de propriété statistiques. L’implémentation de IPropertyStorage gère les données statistiques et est associée à un objet de stockage de fichiers composé actuel.

Le constructeur dans l’implémentation COM de IEnumSTATPROPSTG crée une classe qui lit l’ensemble de propriétés et crée un tableau statique qui peut être partagé lorsque IEnumSTATPROPSTG ::Clone est appelé.

Quand utiliser

Appelez l’implémentation de fichier composé de IEnumSTATPROPSTG pour énumérer les structures STATPROPSTG qui contiennent des données sur les propriétés dans le jeu de propriétés actuel. Lorsque vous utilisez l’implémentation de fichier composé des interfaces de stockage de propriétés, appelez IPropertyStorage ::Enum pour retourner un pointeur vers IEnumSTATPROPSTG pour gérer l’objet de stockage de propriétés et les éléments qu’il contient.

Remarques

IEnumSTATPROPSTG ::Next

Obtient la ou plusieurs structures STATPROPSTG (le nombre est spécifié par le paramètre celt). Retourne S_OK en cas de réussite.

IEnumSTATPROPSTG ::Skip

Ignore le nombre d’éléments spécifiés dans celt. L’élément suivant à énumérer via un appel à Next devient ensuite l’élément après les éléments ignorés. Retourne S_OK si éléments celtes ont été ignorés ; retourne S_FALSE si moins de éléments celtes ont été ignorés.

IEnumSTATPROPSTG ::Reset

Définit le curseur au début de l’énumération. Si elle réussit, retourne S_OK, sinon, retourne STG_E_INVALIDHANDLE.

IEnumSTATPROPSTG ::Clone

Utilise le constructeur pour l'IEnumSTATPROPSTG pour créer une copie du tableau. Étant donné que la classe qui construit le tableau statique contient réellement l’objet, cette fonction s’ajoute principalement au nombre de références.

STATPROPSTG

IPropertyStorage ::Enum