IShellBrowser::GetViewStateStream

[Now Supported on Windows NT]

The browser provides an IStream interface as the storage for view-specific state information.

HRESULT GetViewStateStream(

DWORD grfMode, // Specifies the mode
LPSTREAM *ppStrm // Points to the LPSTREAM variable
);  

Parameters

grfMode

Specifiies the read-write access. This may be set to STGM_READ, STGM_WRITE, or STGM_READWRITE. For more information about these values see the STGM enumeration.

ppStrm

Pointer to the address of the LPSTREAM variable to be filled.

Return Values

Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks

Used to save and restore the persistent state for a view. For example, the icon positions the column widths, and the current scroll position.

Notes to Callers:

Use GetViewStateStream when the view is being created to read in the saved view state and when the view is being closed to save any changes to the view state. Typically, the view calls this member with STGM_READ when creating a view window and with STGM_WRITE when the SaveViewState method of its IShellView interface is called.

Notes to Implementors:

Each shell view should have its own view stream. The Explorer implements an MRU (most recently used) list of view streams that are stored on a per-user basis in the registry.

See Also

IShellBrowser