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

另请参阅

ILayoutStorage::ReLayoutDocfile

ILockBytes

StorageLayout