IOleDocumentView::SaveViewState 方法 (docobj.h)

將檢視狀態儲存至指定的數據流。

語法

HRESULT SaveViewState(
  [in] LPSTREAM pstm
);

參數

[in] pstm

檢視用來儲存其狀態數據的數據流指標。

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_POINTER
pstm 中的值為 NULL
E_NOTIMPL
此檢視沒有有意義的儲存狀態。 此錯誤應該很少見,因為大部分檢視至少有一些值得儲存的狀態資訊。

備註

檢視的狀態包括檢視類型、縮放因數和插入點位置等屬性。 容器通常會在停用檢視之前呼叫此函式。 然後,串流稍後可用來透過 IOleDocumentView::ApplyViewState 將相同檔的檢視重新初始化為此儲存狀態。

根據管理 IPersistStream 的規則,檢視必須將其 CLSID 寫入為數據流中的第一個專案。 套用至檔儲存表示法的任何跨平臺檔格式相容性問題,也適用於此內容。

規格需求

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

另請參閱

IOleDocumentView

IOleDocumentView::ApplyViewState

IPersistStream