IPropertyBag2::Write Method

Causes one or more properties to be saved into the property bag.

Syntax

 HRESULT Write(
    ULONG cProperties,
    PROPBAG2 *pPropBag,
    VARIANT *pvarValue
);

Parameters

cProperties
[in] Number of properties to save. This argument specifies the number of elements in the arrays at pPropBag and pvarValue.
pPropBag
[in] Address of an array of PROPBAG2 structures that specify the properties being saved. The pstrName member of these structures must be filled in before calling this method. The dwHint member of these structures is optional. There must be at least cProperties elements in this array. This argument cannot be NULL.
pvarValue
[out] Address of an array of VARIANT structures that contain the property values to be saved. There must be at least cProperties elements in this array. This argument cannot be NULL.

Return Value

Returns S_OK if the property bag successfully saved all of the properties, or E_FAIL if one or more of the properties could not be saved.