IUIRibbon::SaveSettingsToStream method (uiribbon.h)

Writes ribbon settings to a binary stream.

Syntax

HRESULT SaveSettingsToStream(
  [in] IStream *pStream
);

Parameters

[in] pStream

Type: IStream*

Pointer to an IStream object.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The stream is handed off to the host application for storage as appropriate.

The SaveSettingsToStream method is useful for persisting ribbon state, such as Quick Access Toolbar (QAT) items, across application instances.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header uiribbon.h
DLL Mshtml.dll

See also

IUIRibbon

IUIRibbon::LoadSettingsFromStream

Persisting Ribbon State

Windows Ribbon Framework Samples