StgCreateDocfileOnILockBytes 是 Win32 API 中 coml2api.h 头文件定义的一个函数，用于通过指定的 ILockBytes 接口创建一个根存储对象，通常用于创建复合文档（Compound Document）。

以下是 StgCreateDocfileOnILockBytes 函数的声明：
#include <coml2api.h>

HRESULT StgCreateDocfileOnILockBytes(
  ILockBytes *plkbyt,
  DWORD      grfMode,
  DWORD      reserved,
  IStorage   **ppstgOpen
);

  •  plkbyt: 指向实现了 ILockBytes 接口的对象的指针。ILockBytes 接口通常用于在存储器中实现对数据流的访问。

  
  •  grfMode: 存储对象的打开模式，可以是 STGM_DIRECT、STGM_TRANSACTED 等之一，指定存储对象的访问模式。

  
  •  reserved: 保留参数，必须设置为 0。

  
  •  ppstgOpen: 指向 IStorage 接口指针的指针，用于接收创建的存储对象的指针。


函数成功时返回 S_OK，并将创建的存储对象的指针存储在 ppstgOpen 中。这个函数通常用于在给定的 ILockBytes 接口上创建复合文档的根存储对象，然后可以在该存储对象中创建子存储或流。

以下是一个示例用法：
#include <coml2api.h>

void ExampleStgCreateDocfileOnILockBytes(ILockBytes *pLockBytes) {
    IStorage *pStg = nullptr;

    // Create a new compound document on the specified ILockBytes object
    HRESULT hr = StgCreateDocfileOnILockBytes(pLockBytes, STGM_READWRITE | STGM_SHARE_EXCLUSIVE | STGM_CREATE, 0, &pStg);

    if (SUCCEEDED(hr)) {
        // Use the created storage object (pStg) for further operations

        // Release the storage object when done
        pStg->Release();
    }
}

请注意，在使用 StgCreateDocfileOnILockBytes 创建的存储对象完成操作后，应该调用 Release 方法释放对象。


转载请注明出处：http://www.zyzy.cn/article/detail/24616/Win32 API/Coml2api.h/StgCreateDocfileOnILockBytes