stgOpenLayoutDocfile 函数 (objbase.h)

2025-02-21

不支持。

StgOpenLayoutDocfile 函数在能够监视扇区数据的 ILockBytes 实现上打开一个复合文件。若要调用 StgOpenLayoutDocfile，需要 DfLayout.dll 和 DfLayout.lib。

注意请勿使用此函数。请改用 IStorage：：CopyTo 方法。 CopyTo 可用于对文档文件进行布局，从而在大多数情况下提高性能。

语法

HRESULT StgOpenLayoutDocfile(
  [in]  OLECHAR const *pwcsDfName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstgOpen
);

参数

[in] pwcsDfName

指向要打开的复合文件的以 null 结尾的 Unicode 字符串名称的指针。

[in] grfMode

打开新创建的存储对象时要使用的访问模式。值取自 STGM 常量。请注意，不支持优先级模式和排除项。最常见的访问模式可能是STGM_DIRECT |STGM_READ |STGM_SHARE_EXCLUSIVE。

[in] reserved

保留供将来使用。

[out] ppstgOpen

指向 IStorage 指针变量的指针，该变量接收指向新创建的根存储对象的根对象的接口指针。

返回值

除了以下各项外，此函数还支持标准返回值E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG和E_FAIL：

StgOpenLayoutDocfile 函数还可以返回 StgOpenStorageOnILockBytes 函数返回的任何错误值。

注解

此函数创建的复合文件实现在其根存储上公开 ILayoutStorage 接口。应用程序使用此接口来表达其复合文件的最佳布局，以便通过慢速链接更快地下载和呈现数据。 StgOpenLayoutDocfile 返回指向新创建的复合文件的根存储上的 IStorage 接口的指针。使用此指针，应用程序调用 QueryInterface 以获取指向 ILayoutStorage 的指针。