OleGetAutoConvert - OLE Programmer's Reference

Custom Search

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

Last news from Greatis Software

    Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More »

Recommended software for developers

    Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More »

    Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More »

    Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More »

    Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More »

    Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More »

All the contacts and projects

Dmitry Vasiliev (just.dmitry)

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

greatis just4fun network