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
S_OK	Se devolvió correctamente un valor a través del parámetro pclsidNew .
REGDB_E_CLASSNOTREG	El CLSID no está registrado correctamente en el registro.
REGDB_E_READREGDB	Error al leer del Registro.
REGDB_E_KEYMISSING	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)

Consulte también

AutoConvertto

OleDoAutoConvert

OleSetAutoConvert