IOleDocument：：CreateView 方法 (docobj.h)

發行項
02/29/2024

在呼叫端的程式中建立文件檢視物件，並取得該物件的 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。其他可能的傳回值包括下列專案。

傳回碼	Description
E_FAIL	作業失敗。
E_OUTOFMEMORY	作業的記憶體不足。
E_UNEXPECTED	已發生未預期的錯誤。
E_POINTER	ppView 中的位址為 NULL。

備註

文件物件容器的文件網站會呼叫 CreateView ，指示檔對象從預設數據或使用現有數據流的內容，在容器的程式中建立本身的新檢視。

呼叫 CreateView 並不會讓新檢視自行顯示。若要這樣做，需要呼叫 IOleDocumentView：：Show 或 IOleDocumentView：：UIActivate。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	docobj.h