Interface IStorage (objidl.h)
L’interface IStorage prend en charge la création et la gestion d’objets de stockage structurés. Le stockage structuré permet un stockage hiérarchique des informations au sein d’un seul fichier et est souvent appelé « système de fichiers au sein d’un fichier ». Les éléments d’un objet de stockage structuré sont des stockages et des flux. Les stockages sont analogues aux répertoires, et les flux sont analogues aux fichiers. Dans un stockage structuré, il y aura un objet de stockage principal qui peut contenir des sous-stockages, éventuellement imbriqués et des flux. Les stockages fournissent la structure de l’objet et les flux contiennent les données, qui sont manipulées via l’interface IStream .
L’interface IStorage fournit des méthodes pour créer et gérer l’objet de stockage racine, les objets de stockage enfants et les objets de flux. Ces méthodes peuvent créer, ouvrir, énumérer, déplacer, copier, renommer ou supprimer les éléments dans l’objet de stockage.
Une application doit libérer ses pointeurs IStorage lorsqu’elle est effectuée avec l’objet de stockage pour libérer la mémoire utilisée. Il existe également des méthodes pour modifier la date et l’heure d’un élément.
Il existe un certain nombre de modes différents dans lesquels un objet de stockage et ses éléments peuvent être ouverts, déterminés en définissant des valeurs à partir de constantes STGM. L’un des aspects suivants est la façon dont les modifications sont validées. Vous pouvez définir le mode direct, dans lequel les modifications apportées à un objet y sont immédiatement écrites, ou le mode transactionné, dans lequel les modifications sont écrites dans une mémoire tampon jusqu’à ce qu’elles soient validées explicitement. L’interface IStorage fournit des méthodes pour valider les modifications et revenir à la dernière version validée. Par exemple, un flux peut être ouvert en mode lecture seule ou en mode lecture/écriture. Pour plus d’informations, consultez constantes STGM.
D’autres méthodes fournissent l’accès aux informations relatives à un objet de stockage et à ses éléments via la structure STATSTG .
Héritage
L’interface IStorage hérite de l’interface IUnknown . IStorage possède également ces types de membres :
Méthodes
L’interface IStorage a ces méthodes.
| IStorage::Commit La méthode Commit garantit que toutes les modifications apportées à un objet de stockage ouvert en mode transactionné sont reflétées dans le stockage parent. |
| IStorage::CopyTo Copie l’intégralité du contenu d’un objet de stockage ouvert vers un autre objet de stockage. |
| IStorage::CreateStorage Crée et ouvre un nouvel objet de stockage imbriqué dans cet objet de stockage avec le nom spécifié dans le mode d’accès spécifié. |
| IStorage::CreateStream Crée et ouvre un objet de flux avec le nom spécifié contenu dans cet objet de stockage. |
| IStorage::D estroyElement Supprime le stockage ou le flux spécifié de cet objet de stockage. |
| IStorage::EnumElements La méthode EnumElements récupère un pointeur vers un objet énumérateur qui peut être utilisé pour énumérer les objets de stockage et de flux contenus dans cet objet de stockage. |
| IStorage::MoveElementTo La méthode MoveElementTo copie ou déplace un sous-historique ou un flux de cet objet de stockage vers un autre objet de stockage. |
| IStorage::OpenStorage Ouvre un objet de stockage existant avec le nom spécifié dans le mode d’accès spécifié. |
| IStorage::OpenStream Ouvre un objet de flux existant dans cet objet de stockage en mode d’accès spécifié. |
| IStorage::RenameElement La méthode RenameElement renomme le sous-stockage ou le flux spécifié dans cet objet de stockage. |
| IStorage::Revert La méthode Revert ignore toutes les modifications apportées à l’objet de stockage depuis la dernière opération de validation. |
| IStorage::SetClass La méthode SetClass affecte l’identificateur de classe spécifié (CLSID) à cet objet de stockage. |
| IStorage::SetElementTimes La méthode SetElementTimes définit les heures de modification, d’accès et de création de l’élément de stockage spécifié, si le système de fichiers sous-jacent prend en charge cette méthode. |
| IStorage::SetStateBits La méthode SetStateBits stocke jusqu’à 32 bits d’informations d’état dans cet objet de stockage. |
| IStorage::Stat La méthode Stat récupère la structure STATSTG pour cet objet de stockage ouvert. |
Configuration requise
| 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 | objidl.h |