The IPersistStreamInit interface is defined as a replacement for IPersistStream in order to add an initialization method, InitNew. This interface is not derived from IPersistStream; it is mutually exclusive with IPersistStream. An object chooses to support only one of the two interfaces, based on whether it requires the InitNew method. Otherwise, the signatures and semantics of the other methods are the same as the corresponding methods of IPersistStream, except as described below.
Implement this interface on any object that needs to support initialized stream-based persistence, regardless of whatever else the object does. The presence of the InitNew method requires some changes to other methods that are common to IPersistStream, as noted in the method descriptions.
Use this interface to initialize a stream-based object and to save that object to a stream.
QueryInterface
Returns pointers to supported interfaces.
AddRef
Increments reference count.
Release
Decrements reference count.
GetClassID
Returns the class identifier (CLSID) for the component object.
IsDirty
Checks the object for changes since it was last saved.
Load
Initializes an object from the stream where it was previously saved.
Save
Saves an object into the specified stream and indicates whether the object should reset its dirty flag.
GetSizeMax
Return the size in bytes of the stream needed to save the object.
InitNew
Initializes an object to a default state.
For an explanation of the requirement values, see Requirements (COM).
Windows NT/2000/XP: Requires Windows NT 3.1 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in ocidl.h.