Partager via

implémentation de fichier IEnumSTATPROPSTG-Compound

  • Article

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

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

Quand l’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é, appelez IPropertyStorage::Enum pour renvoyer un pointeur vers IEnumSTATPROPSTG pour gérer l’objet de stockage de propriété et les éléments qu’il contient.

Notes

IEnumSTATPROPSTG::Next

Obtient la ou plusieurs structures STATPROPSTG suivantes (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 le celte. L’élément suivant à énumérer via un appel à Next devient alors l’élément après les éléments ignorés. Retourne S_OK si les éléments celtes ont été ignorés ; retourne S_FALSE si moins d’éléments celtes ont été ignorés.

IEnumSTATPROPSTG::Reset

Définit le curseur sur le début de l’énumération. En cas de réussite, retourne S_OK, sinon, retourne STG_E_INVALIDHANDLE.

IEnumSTATPROPSTG::Clone

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

STATPROPSTG

IPropertyStorage::Enum