IPersistStreamInit  613F0H0

The IPersistStreamInit interface is defined as a replacement for IPersistStream4KTV_NZ 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.

When to Implement

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.

When to Use

Use this interface to initialize a stream-based object and to save that object to a stream.

Methods in Vtable Order

IUnknown Methods

Description

QueryInterface2Y54585

Returns pointers to supported interfaces.

AddRef1SHW0SS

Increments reference count.

ReleaseDUW01A

Decrements reference count.

 

IPersistStreamInit Methods

Description

IsDirtyBLR5TZ

Checks the object for changes since it was last saved.

LoadFYB_CD

Initializes an object from the stream where it was previously saved.

SaveFYHZXE

Saves an object into the specified stream and indicates whether the object should reset its dirty flag.

GetSizeMax2K.71BK

Return the size in bytes of the stream needed to save the object.

InitNew_R21EX

Initializes an object to a default state.

 

See Also

IPersistStream