Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’implémentation autonome fournie par le système de IPropertySetStorage inclut une implémentation des deux IPropertyStorage et IPropertySetStorage.IPropertyStorage est l’interface qui lit et écrit les propriétés dans un stockage de jeu de propriétés. IPropertySetStorage est l’interface qui crée et ouvre des jeux de propriétés dans un stockage. Les interfaces IEnumSTATPROPSTG et IEnumSTATPROPSETSTG sont également fournies dans l’implémentation autonome.
Pour utiliser l’implémentation autonome de IPropertySetStorage, commencez par obtenir un pointeur vers l’implémentation autonome fournie par le système et associez l’implémentation fournie par le système à votre objet de stockage. Pour obtenir un pointeur vers l’implémentation autonome de IPropertySetStorage, appelez la fonction StgCreatePropSetStg et fournissez le paramètre pStorage spécifiant l’objet de stockage qui contiendra le jeu de propriétés. Cette fonction fournit un pointeur vers la nouvelle interface IPropertySetStorage pour l’objet de stockage spécifié.
L’implémentation autonome de IPropertySetStorage crée des jeux de propriétés sur n’importe quel objet de stockage, pas seulement sur les stockages de fichiers composés. L’implémentation autonome ne dépend pas des fichiers composés et peut être utilisée avec n’importe quelle implémentation de stockages structurés. Toutes les restrictions sur les stockages structurés fournis par l’appelant s’appliquent à cette implémentation des jeux de propriétés. Par exemple, si vous fournissez un stockage en mode simple pour StgOpenPropStg, le IPropertySetStorage résultant sera limité par le IStorage fourni.
Pour plus d’informations sur l’implémentation de fichier composé de cette interface, consultez la section IPropertySetStorage-Compound implémentation de fichier.
Quand utiliser
Appelez les méthodes de IPropertySetStorage pour créer, ouvrir et supprimer des jeux de propriétés dans n’importe quel stockage structuré. Il existe également une méthode qui fournit un pointeur vers le IEnumSTATPROPSETSTG énumérateur qui peut être utilisé pour énumérer les jeux de propriétés dans le stockage.
L’implémentation autonome fournit également les fonctions d’assistance StgCreatePropStg et StgOpenPropStg d’assistance, en plus des méthodes Create et Open, pour créer et ouvrir des jeux de propriétés. Ces deux fonctions ajoutent la prise en charge de la valeur PROPSETFLAG_UNBUFFERED afin de pouvoir écrire des modifications directement dans le jeu de propriétés au lieu de les mettre en mémoire tampon dans un cache. Pour plus d’informations, consultez constantes PROPSETFLAG.
Méthode
L’implémentation autonome de IPropertySetStorage prend en charge les méthodes suivantes.
-
Crée un jeu de propriétés dans le stockage et retourne un pointeur vers l’interface IPropertyStorage sur le jeu de propriétés.
Si vous envisagez d’utiliser la valeur PROPSETFLAG_UNBUFFERED, utilisez la fonctionStgCreatePropStgà la place pour créer et ouvrir le jeu de propriétés et obtenir un pointeur vers l’implémentation autonome pour l’interface IPropertyStorage sur le jeu de propriétés.
-
Ouvre un jeu de propriétés existant dans le stockage et retourne un pointeur vers l’interface IPropertyStorage sur le jeu de propriétés.
Si vous envisagez d’utiliser la valeur PROPSETFLAG_UNBUFFERED, utilisez la fonction StgOpenPropStg à la place pour obtenir un pointeur vers l’implémentation autonome de IPropertyStorage sur le jeu de propriétés spécifié.
-
Supprime un jeu de propriétés dans ce stockage de jeu de propriétés.
-
Crée un objet qui peut être utilisé pour énumérer structures STATPROPSETSTG. Chaque statPROPSETSTG structure fournit des données sur un jeu de propriétés unique.
Note
Le jeu de propriétés DocumentSummaryInformation et UserDefined est unique dans lequel il peut avoir deux sections de jeu de propriétés dans un seul flux sous-jacent. Pour plus d’informations, consultez Les ensembles de propriétés DocumentSummaryInformation et UserDefined .
Rubriques connexes