Save method

Instructs the object to save its persistent data to memory.

Syntax

HRESULT retVal = object.Save(pvMem, fClearDirty, cbSize);

Parameters

• pvMem [in]
  Type: void

  The address of the memory in which the object should save up to cbSize bytes of its data. The object must not write past the address (BYTE*)((BYTE *)pvMem+cbSize).

• fClearDirty [in]
  Type: BOOL

  A flag indicating whether the object should clear its dirty state on return from IPersistMemory::Save, or leave that state as is.

• cbSize [in]
  Type: unsigned long

  The amount of memory available at pvMem to which the object can write its data.

Remarks

Any object that implements IPersistMemory has some information to save persistently; therefore, E_NOTIMPL is not a valid return code.

The caller should allocate as many bytes as the object returns from IPersistMemory::GetSizeMax.