IShellBrowser：：GetViewStateStream 方法 (shobjidl_core.h)

發行項
03/02/2024

取得可用於儲存檢視特定狀態資訊的 IStream 介面。

語法

HRESULT GetViewStateStream(
  DWORD   grfMode,
  IStream **ppStrm
);

參數

grfMode

類型： DWORD

IStream 介面的讀取/寫入存取權。這可能是下列其中一個值。

STGM_READ

要求適合讀取的 IStream 。

STGM_WRITE

要求適合寫入的 IStream 。

STGM_READWRITE

要求適合讀取和寫入的 IStream 。

ppStrm

類型： IStream**

接收 IStream 介面指標的位址。

傳回值

類型： HRESULT

如果成功，則傳回S_OK，否則傳回 COM 定義的錯誤值。

備註

這個方法可用來儲存和還原檢視的持續性狀態， (圖示位置、數據行寬度和目前的捲動位置，例如) 。

呼叫應用程式的注意事項

在建立檢視時使用 GetViewStateStream 來讀取已儲存的檢視狀態，以及關閉檢視以儲存檢視狀態的任何變更時。一般而言，當建立檢視視窗，並在呼叫其 IShellView 介面的 SaveViewState 方法時，使用 STGM_WRITE 呼叫這個方法時，檢視會使用 STGM_READ 呼叫此方法。

實作者的注意事項

每個殼層檢視都應該有自己的檢視數據流。 Windows 檔案總管會實作最近使用的 (MRU) 檢視數據流清單，這些數據流會以每個使用者為基礎儲存在登錄中。

另請參閱 IShellBrowser

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)
Dll	Shell32.dll (4.0 版或更新版本)

共用方式為