Función CoGetTreatAsClass (combaseapi.h)

Devuelve el CLSID de un objeto que puede emular el objeto especificado.

Sintaxis

HRESULT CoGetTreatAsClass(
  [in]  REFCLSID clsidOld,
  [out] LPCLSID  pClsidNew
);

Parámetros

[in] clsidOld

CLSID del objeto que se puede emular (tratar como) un objeto con un CLSID diferente.

[out] pClsidNew

Puntero a donde se recupera el CLSID que puede emular objetos clsidOld . Este parámetro no puede ser NULL. Si no hay información de emulación para objetos clsidOld , se proporciona el parámetro clsidOld .

Valor devuelto

Esta función puede devolver los valores siguientes, así como los valores de error devueltos por la función CLSIDFromString .

Código devuelto	Descripción
S_OK	Se devolvió correctamente un nuevo CLSID.
S_FALSE	No hay información de emulación para el parámetro clsidOld , por lo que el parámetro pClsidNew se establece en clsidOld.
REGDB_E_READREGDB	Error al leer el registro.

Comentarios

CoGetTreatAsClass devuelve la entrada TreatAs en el Registro para el objeto especificado. La entrada TreatAs , si se establece, es el CLSID de un objeto registrado (una aplicación) que puede emular el objeto en cuestión. La entrada TreatAs se establece a través de una llamada a la función CoTreatAsClass . La emulación permite que una aplicación abra y edite un objeto de un formato diferente, a la vez que conserva el formato original del objeto. Los objetos del CLSID original se activan y tratan como objetos del segundo CLSID. Cuando se guarda el objeto, esto puede dar lugar a la pérdida de ediciones no admitidas por el formato original. Si no hay ninguna entrada TreatAs para el objeto especificado, esta función devuelve el CLSID del objeto original (clsidOld).

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	combaseapi.h (incluya Objbase.h)
Library	Ole32.lib
Archivo DLL	Ole32.dll

Consulte también

CoTreatAsClass