ILayoutStorage::LayoutScript 方法 (objidl.h)
LayoutScript 方法为复合文件中的存储、流和控件重新排序提供了显式方向,以匹配下载过程中访问它们的顺序。
语法
HRESULT LayoutScript(
[in] StorageLayout *pStorageLayout,
[in] DWORD nEntries,
[in] DWORD glfInterleavedFlag
);
参数
[in] pStorageLayout
指向 StorageLayout 结构数组的指针。
[in] nEntries
StorageLayout 结构数组中的条目数。
[in] glfInterleavedFlag
保留供将来使用。
返回值
此函数支持标准返回值E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG和E_FAIL,以及以下内容:
返回代码 | 说明 |
---|---|
STG_E_INVALIDPOINTER | 存储布局指针无效。 |
STG_E_INVALIDFLAG | glfInterleavedFlag 的值无效。 |
STG_E_PATHNOTFOUND | 指定的新文档文件名无效。 |
STG_E_INSUFFICIENTMEMORY | 内存不足,无法完成此操作。 |
STG_E_INVALIDPARAMETER | 其中一个参数无效。 |
STG_E_INUSE | 在 ILayoutStorage 已在监视时调用 BeginMonitor 方法。 |
注解
为了提供显式布局说明,应用程序调用 ILayoutStorage::LayoutScript,传递 StorageLayout 结构的数组。 每个结构定义单个存储或流数据块,并指定要在 ILockBytes 字节数组中写入块的位置。
应用程序可以将脚本布局与监视相结合,因为特定复合文件的结构可能规定。
确定整个复合文件的最佳数据布局模式后,应用程序会调用 ILayoutStorage::ReLayoutDocfile 来重构复合文件,使其与访问其数据扇区的顺序相匹配。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | objidl.h |
Library | Uuid.lib |
DLL | Ole32.dll |