Interfaz IStorage (objidl.h)
La interfaz IStorage admite la creación y administración de objetos de almacenamiento estructurados. El almacenamiento estructurado permite el almacenamiento jerárquico de información dentro de un único archivo y a menudo se conoce como "un sistema de archivos dentro de un archivo". Los elementos de un objeto de almacenamiento estructurado son almacenamientos y secuencias. Los almacenamientos son análogos a los directorios y los flujos son análogos a los archivos. Dentro de un almacenamiento estructurado, habrá un objeto de almacenamiento principal que puede contener substorages, posiblemente anidados y flujos. Los almacenamientos proporcionan la estructura del objeto y los flujos contienen los datos, que se manipulan a través de la interfaz IStream .
La interfaz IStorage proporciona métodos para crear y administrar el objeto de almacenamiento raíz, los objetos de almacenamiento secundarios y los objetos de secuencia. Estos métodos pueden crear, abrir, enumerar, mover, copiar, cambiar el nombre o eliminar los elementos del objeto de almacenamiento.
Una aplicación debe liberar sus punteros de IStorage cuando haya terminado con el objeto de almacenamiento para desasignar la memoria usada. También hay métodos para cambiar la fecha y hora de un elemento.
Hay varios modos diferentes en los que se puede abrir un objeto de almacenamiento y sus elementos, determinados estableciendo valores de constantes STGM. Un aspecto de esto es cómo se confirman los cambios. Puede establecer el modo directo, en el que los cambios en un objeto se escriben inmediatamente en él o en modo transaccionado, en el que los cambios se escriben en un búfer hasta que se confirmen explícitamente. La interfaz IStorage proporciona métodos para confirmar los cambios y revertir a la última versión confirmada. Por ejemplo, una secuencia se puede abrir en modo de solo lectura o en modo de lectura y escritura. Para obtener más información, vea Constantes STGM.
Otros métodos proporcionan acceso a información sobre un objeto de almacenamiento y sus elementos a través de la estructura STATSTG .
Herencia
La interfaz IStorage hereda de la interfaz IUnknown . IStorage también tiene estos tipos de miembros:
Métodos
La interfaz IStorage tiene estos métodos.
| IStorage::Commit El método Commit garantiza que los cambios realizados en un objeto de almacenamiento abierto en modo transaccionado se reflejan en el almacenamiento primario. |
| IStorage::CopyTo Copia todo el contenido de un objeto de almacenamiento abierto en otro objeto de almacenamiento. |
| IStorage::CreateStorage Crea y abre un nuevo objeto de almacenamiento anidado dentro de este objeto de almacenamiento con el nombre especificado en el modo de acceso especificado. |
| IStorage::CreateStream Crea y abre un objeto de secuencia con el nombre especificado incluido en este objeto de almacenamiento. |
| IStorage::D estroyElement Quita el almacenamiento o la secuencia especificados de este objeto de almacenamiento. |
| IStorage::EnumElements El método EnumElements recupera un puntero a un objeto enumerador que se puede usar para enumerar los objetos de almacenamiento y secuencia contenidos en este objeto de almacenamiento. |
| IStorage::MoveElementTo El método MoveElementTo copia o mueve un substorage o un flujo de este objeto de almacenamiento a otro objeto de almacenamiento. |
| IStorage::OpenStorage Abre un objeto de almacenamiento existente con el nombre especificado en el modo de acceso especificado. |
| IStorage::OpenStream Abre un objeto de secuencia existente dentro de este objeto de almacenamiento en el modo de acceso especificado. |
| IStorage::RenameElement El método RenameElement cambia el nombre del substorage o la secuencia especificados en este objeto de almacenamiento. |
| IStorage::Revert El método Revert descarta todos los cambios realizados en el objeto de almacenamiento desde la última operación de confirmación. |
| IStorage::SetClass El método SetClass asigna el identificador de clase especificado (CLSID) a este objeto de almacenamiento. |
| IStorage::SetElementTimes El método SetElementTimes establece las horas de modificación, acceso y creación del elemento de almacenamiento especificado, si el sistema de archivos subyacente admite este método. |
| IStorage::SetStateBits El método SetStateBits almacena hasta 32 bits de información de estado en este objeto de almacenamiento. |
| IStorage::Stat El método Stat recupera la estructura STATSTG para este objeto de almacenamiento abierto. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | objidl.h |