IPropertyBag interface

Provides an object with a property bag in which the object can save its properties persistently.

Members

The IPropertyBag interface inherits from the IUnknown interface. IPropertyBag also has these types of members:

  • Methods

Methods

The IPropertyBag interface has these methods.

Method Description
Read

Tells the property bag to read the named property into a caller-initialized VARIANT.

Write

Tells the property bag to save the named property in a caller-initialized VARIANT.

 

Remarks

To read a property in IPersistPropertyBag::Load, the object calls IPropertyBag::Read. When the object saves properties in IPersistPropertyBag::Save, it calls IPropertyBag::Write. Each property is described with a name, whose value is stored in a VARIANT. This information allows a client to save the property values as text, for example; which is the primary reason why a client might choose to support IPersistPropertyBag.

The client records errors that occur during Read in the supplied error log.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Ocidl.h

IDL

Ocidl.idl

See also

IPropertyBag2