Tags an object for automatic conversion to a different class when the object
| REFCLSID clsidOld,
||//CLSID to be converted
| REFCLSID clsidNew
||//New CLSID after conversion
Specifies the CLSID of the object class to be converted.
Specifies the CLSID of the object class that should replace clsidOld
. This new CLSID replaces any existing auto-conversion information in the
registration database for clsidOld
. If this value is CLSID_NULL, any existing auto-conversion information for clsidOld
is removed from the registration database.
Indicates the object was tagged successfully.
Indicates the CLSID is not properly registered in the registration database.
Indicates error reading from the registration database.
Indicates error writing to the registration database.
Indicates cannot read a key from the registration database.
Indicates the auto-conversion cannot be completed due to a lack of memory.
Indicates one or more arguments are invalid.
Indicates an unexpected error occurred.
function sets the entry for AutoConvertTo entry for clsidOld
in the registration database. This function does no validation of whether an
appropriate registration database entry for clsidNew
currently exists. When it is called, the OleSetAutoConvert
function records the new CLSID for the object under the AutoConvertTo subkey
in the registration database for clsidOld
Object conversion means that the object is permanently associated with a new
CLSID. Automatic conversion is typically specified by the setup program for a
new version of an object application, so that objects created by its older
versions can be automatically updated. You can write the setup program to tag a class
of objects for automatic conversion to a different class of objects.
For example, a new version of a spreadsheet application may need to convert
spreadsheets that were created with earlier versions of the application. These
earlier version spreadsheet objects have a different CLSID than the new version.
The setup program for the new version of the spreadsheet application tags
objects in the registration database that have the old CLSID so they are
automatically updated when they are loaded.
When installing a new CLSID, setup programs may call OleSetAutoConvert
for various clsidOld
values for older versions of their applications. They also should call OleSetAutoConvert
, specifying the new class as the clsidOld
parameter, and setting the clsidNew
parameter to CLSID_NULL to remove any existing conversion for the new class.
function creates the required entry in the registration database. These
entries appear in the registration database as subkeys of the CLSID key:
\AutoConvertTo = clsid
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages