OleGetAutoConvert

Returns the new CLSID to which the specified object can be automatically converted. This conversion CLSID is stored in the registration database.

HRESULT OleGetAutoConvert(

REFCLSID clsidOld,	//CLSID of the object to be converted
LPCLSID pClsidNew	//Pointer to new CLSID for object being converted
);

Parameters

clsidOld

Specifies the CLSID for an object that can be automatically converted.

pClsidNew

Points to location where the new CLSID, if any, is returned. The original object, clsidOld, is automatically converted to this new CLSID when the object is opened. If there is no auto-conversion CLSID stored in the registration database, the value clsidOld is returned; the pClsidNew parameter cannot be NULL.

Return Values

S_OK

Indicates that a value was successfully returned through the pclsidNew parameter.

REGDB_E_CLASSNOTREG

Indicates the clsidOld CLSID is not properly registered in the registration database.

REGDB_E_READREGDB

Indicates error reading the registration database.

REGDB_E_KEYMISSING

Indicates auto convert is not active or there was no registration entry for the clsidOld parameter.

E_OUTOFMEMORY

Indicates the value was not returned due to a lack of memory.

E_INVALIDARG

Indicates one or more arguments are invalid.

E_UNEXPECTED

Indicates an unexpected error occurred.

Comments

This function returns the AutoConvertTo entry in the registration database for the specified object, which specifies whether objects of a given CLSID are to be automatically converted to a new CLSID. This is usually set up to convert files created by older versions of an application to the current version. If there is no AutoConvertTo entry, this function returns the value of clsidOld. This function is typically called by the OleDoAutoConvert function to determine if the object specified needs to be converted. If the object has an AutoConvertTo entry, then it will be converted.

Automatic conversion is typically set up during the installation of an object application. The setup program can take advantage of the AutoConvertTo subkey 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.

To tag the old spreadsheet objects, the setup program calls the OleSetAutoConvert function and passes it to the CLSIDs of the source and destination object classes. The OleSetAutoConvert function creates the required entry in the registration database. These entries appear in the registration database as subkeys of the CLSID key:

CLSID\{clsid}=MainUserTypeName\AutoConvertTo = clsid

See Also

OleSetAutoConvert, OleDoAutoConvert

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples

Databases for Amazon shops developers

Amazon Categories Database
Browse Nodes Database