当前位置：首页 > news >正文

2507C++,结构化存储与复合文件

news 2025/7/28 7:41:36

原文

结构化存储和复合文件

结构化存储是一个,抽象了COM接口背后的文件和目录主要是IStorage和IStream的概念的窗口技术.它的主要目的是提供一个在单个物理文件中有文件系统层次的方法,这里.
这里
这里

结构化存储已有多年,其中最著名的用法是在办公文件,在使用扩展文件格式(*.docx,*.pptx等)之前的办公文件(*.doc,*.ppt,*.xls等).
当然,旧格式仍得到很大的支持.

结构化存储接口(IStorage表示目录,IStream表示文件)只是接口.要实际使用它们,必须要有一些实现.窗口提供了一个叫复合文件的结构化存储实现,这里.

这些术语有时可互换使用,但区别很重要:复合文件只是结构化存储的一个实现,可能还有其他实现.复合文件并不是都基于定义的结构化存储,但它实现了很多,因此绝对够用.

可下载用图形方式查看使用复合文件实现创建的物理文件的内容的叫SSView的旧工具(但仍运行良好).
下面是一个更有趣的示例,使用Sysinternals的自动运行工具保留的信息.
尽管它们都在一个文件中,更有趣的层次清晰可见!

主要接口

IStorage接口表示一个可包含其他目录和按IStream接口实现表示"文件"的"目录".要开始,可用StgCreateStorageEx创建物理文件,也可用StgOpenStorageEx打开现有文件.
这里
这里

成功时,两者都返回IStorage指针.从那里,可调用IStorage上的方法来创建或打开其他目录(存储)和/或文件(流).

IStorage上最有用的方法是CreateStorage,CreateStream,OpenStorage和OpenStream.使用EnumElements可枚举存储/流.

以下是打开复合文件以读取访问的示例,文件名来自命令行参数:

CComPtr<IStorage> spStg;
auto hr = ::StgOpenStorageEx(argv[1], STGM_READ | STGM_SHARE_EXCLUSIVE,STGFMT_STORAGE, 0, nullptr, nullptr, __uuidof(IStorage), reinterpret_cast<void**>(&spStg));
if (FAILED(hr)) {printf("Failed to open file (0x%X)\n", hr);return hr;
}

下面说明了如何递归枚举给定存储的层次:

void EnumItems(IStorage* stg, int indent = 0) {CComPtr<IEnumSTATSTG> spEnum;stg->EnumElements(0, nullptr, 0, &spEnum);if (spEnum == nullptr)return;STATSTG stat;while (S_OK == spEnum->Next(1, &stat, nullptr)) {if (indent)printf(std::string(indent, ' ').c_str());printf("%ws", stat.pwcsName);if (stat.type == STGTY_STORAGE) {printf(" [DIR]\n");CComPtr<IStorage> spSubStg;stg->OpenStorage(stat.pwcsName, nullptr,STGM_READ | STGM_SHARE_EXCLUSIVE, 0, 0, &spSubStg);if (spSubStg)EnumItems(spSubStg, indent + 1);}elseprintf(" (%u bytes)\n", stat.cbSize.LowPart);::CoTaskMemFree(stat.pwcsName);}
}

每一项都有一个名字,但流("文件")可有数据.STATSTG的cbSize成员返回该大小.
流只是抽象一堆字节.要实际读取/写入流,需要先使用IStorage::OpenStream打开它,然后再使用IStream::Read,IStream::Write和类似方法访问数据.

流的`更多信息`

在窗口接口中到处使用IStream接口,而不仅是结构化存储的一部分.它代表了抽象了,理论上可以是任何地方的缓冲,这就是抽象的好处.

给定IStream指针,你可读取,写入,查找,复制进另一个流,克隆,甚至只要实现支持,可提交/恢复事务.顺便,复合文件不支持流上的事务.

在结构化存储之外,可通过多种方式取流.

CreateStreamOnHGlobalAPI在可选HGLOBAL上创建内存缓冲(可为无效以分配新缓冲),并返回该内存缓冲的IStream指针.
这里

如,这在处理剪切板时很有用,因为它需要一个可能不方便使用的HGLOBAL.
通过取IStream指针,代码可用它(可能从另一个流中读取它,或手动填充数据),然后调用GetHGlobalFromStream以取底层HGLOBAL,然后再(如SetClipboardData)把它传递进剪切板.

只要可方便访问按IStream抽象的文件数据,还可调用SHCreateStreamOnFile直接取文件的流.
这里
活扩控件持久化中也使用IStream.

使用IStream的另一例是,按COM对象状态信息"打包",这允许调用CoMarshalInterThreadInterfaceInStream(可能是名最长的COMAPI),从不同单元创建该对象的代理,该API(按IStream)抓要传递给另一个单元(A)要求的状态,如果需要,A可调用相应的CoGetInterfaceAndReleaseStream来生成原对象的代理.
这里
这里