Función OleGetAutoConvert (ole2.h)
Determina si el Registro está establecido para que los objetos de un CLSID especificado se conviertan automáticamente en otro CLSID y, si es así, recupera el nuevo CLSID.
Sintaxis
HRESULT OleGetAutoConvert(
[in] REFCLSID clsidOld,
[out] LPCLSID pClsidNew
);
Parámetros
[in] clsidOld
CLSID del objeto .
[out] pClsidNew
Puntero a una variable para recibir el nuevo CLSID, si existe. Si la conversión automática de clsidOld no está establecida en el registro, se devuelve clsidOld . El parámetro pClsidNew nunca es NULL.
Valor devuelto
Esta función puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_UNEXPECTED, así como los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
Se devolvió correctamente un valor a través del parámetro pclsidNew . |
|
El CLSID no está registrado correctamente en el registro. |
|
Error al leer del Registro. |
|
La conversión automática no está activa o no hubo ninguna entrada del Registro para el parámetro clsidOld . |
Comentarios
OleGetAutoConvert devuelve la entrada AutoConvertTo en el Registro para el objeto especificado. La subclave AutoConvertTo especifica si los objetos de un CLSID determinado se van a convertir automáticamente en un nuevo CLSID. Normalmente se usa para convertir archivos creados por versiones anteriores de una aplicación a la versión actual. Si no hay ninguna entrada AutoConvertTo , esta función devuelve el valor de clsidOld.
La función OleDoAutoConvert llama a OleGetAutoConvert para determinar si el objeto especificado se va a convertir. Una aplicación contenedora que admita la conversión de objetos debe llamar a OleDoAutoConvert cada vez que carga un objeto. Si el contenedor usa la función auxiliar OleLoad , no necesita llamar explícitamente a OleDoAutoConvert porque OleLoad lo llama internamente.
Para configurar la conversión automática de una clase determinada, puede llamar a la función OleSetAutoConvert (normalmente en el programa de instalación de una instalación de aplicación). Esta función usa la subclave AutoConvertTo para etiquetar una clase de objetos para la conversión automática a otra clase de objetos. Se trata de una subclave de la clave CLSID.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ole2.h |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |
| Conjunto de API | ext-ms-win-com-ole32-l1-1-0 (introducido en Windows 8) |