IOleDocument：：CreateView 方法 (docobj.h)

项目
08/23/2023

在调用方进程中创建一个文档视图对象，并获取指向该对象的 IOleDocumentView 接口的指针。

语法

HRESULT CreateView(
  [in]  IOleInPlaceSite  *pIPSite,
  [in]  IStream          *pstm,
  [in]  DWORD            dwReserved,
  [out] IOleDocumentView **ppView
);

参数

[in] pIPSite

指向 IOleInPlaceSite 接口的指针，该接口表示要与新文档视图对象关联的视图网站对象。例如，当视图包含在新的未初始化文档对象中时，此参数可以为 NULL，在这种情况下，调用方必须使用对 IOleDocumentView：：SetInPlaceSite 的后续调用来初始化视图。

[in] pstm

指向包含数据（新文档视图对象应从中初始化自身）的流的指针。如果 为 NULL，则文档对象使用默认状态初始化新的文档视图对象。

[in] dwReserved

此参数是保留的，必须为零。

[out] ppView

指向 IOleDocumentView 指针变量的指针，该变量接收指向新文档视图对象的接口指针。成功后，当不再需要视图对象时，调用方负责在 ppview 指针上调用 IUnknown：：Release。

返回值

此方法在成功时返回S_OK。其他可能的返回值包括以下内容。

返回代码	说明
E_FAIL	此操作失败。
E_OUTOFMEMORY	可用于操作的内存不足。
E_UNEXPECTED	发生意外错误。
E_POINTER	ppView 中的地址为 NULL。

注解

文档对象容器的文档网站调用 CreateView ，以指示文档对象从默认数据或使用现有流的内容在容器的进程中创建其自身的新视图。

调用 CreateView 不会导致新视图本身显示。为此，需要调用 IOleDocumentView：：Show 或 IOleDocumentView：：UIActivate。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	docobj.h