IPropertyStorage::SetClass
Assigns a new
CLSID to the current property storage object, and persistently stores the CLSID
with the object.
HRESULT
SetClass(
|
REFCLSID clsid |
//New CLSID for the property set |
|
); |
|
Parameters
clsid
[in] New
CLSID to be associated with the property set.
Return Values
This method
supports the standard return value E_UNEXPECTED, as well as the following:
S_OK
The CLSID has
been assigned.
STG_E_ACCESSDENIED
The requested
access to the IPropertyStorage interface has been denied. The CLSID was
not assigned.
STG_E_INSUFFICIENTMEMORY
There is not
sufficient memory to perform this operation. The CLSID was not assigned.
STG_E_INVALIDPARAMETER
The parameter
is invalid. The CLSID was not assigned.
Remarks
Assigns a
CLSID to the current property storage object. The CLSID has no relationship to
the stored property identifiers. Assigning a CLSID allows a piece of code to be
associated with a given instance of a property set; such code, for example,
might manage the user interface. Different CLSIDs can be associated with
different property set instances that have the same FMTID.
If the
property set is created with NULL specified as the IPropertySetStorage::Create
pclsid parameter, the CLSID is set to all zeroes.
The current
CLSID on a property storage object can be retrieved with a call to IPropertyStorage::Stat. The initial value for the
CLSID can be specified at the time that the storage is created with a call to IPropertySetStorage::Create.
Setting the CLSID
on a non-simple property set (one that can legally contain storage- or
stream-valued properties, as described in IPropertySetStorage::Create)
also sets the CLSID on the underlying sub-storage.
See Also