CoGetTreatAsClass

9/8/2008

Essa função retorna a CLSID de um objeto que pode emular o objeto especificado.

Syntax

HRESULT CoGetTreatAsClass(
  REFCLSID clsidOld,
  LPCLSID pclsidNew
);

Parameters

• clsidOld
  [no] CLSID do objeto que pode ser emulado (tratado como) um objeto com um CLSID diferente.

• pclsidNew
  [out] Ponteiro para onde o CLSID que pode emular clsidOld Os objetos são recuperados. Esse parâmetro não pode ser NULL. Se não houver nenhum informações de Emulação para clsidOld objetos, o clsidOld parâmetro for fornecido.

Return Value

• S_OK
  Um novo CLSID foi retornado com êxito.

• S_FALSE
  Há informações de Emulação para o clsidOld parâmetro e que o pclsidNew parâmetro for definido como clsidOld.

• REGDB_E_READREGDB
  Um erro ao ler o Registro.

Essa função também pode retornar qualquer um dos valores de erro retornados pelo CLSIDFromString função.

Remarks

CoGetTreatAsClass Retorna o TreatAs entrada no Registro para o objeto especificado. O TreatAs entrada, se definido, é a CLSID de um objeto registrado (um aplicativo) que pode emular o objeto em questão. O TreatAs entrada é definida por um chamar para o CoTreatAsClass função.

Emulação permite que um aplicativo para aberto e editar um objeto de um formato diferente, mantendo o original formato do objeto. Objetos do original CLSID são ativados e tratados como objetos de CLSID o segundo.

Quando o objeto é salvo, isso pode resultar em perda de edições não com suporte pelo original formato. Se nenhum TreatAs entrada para o objeto especificado, essa função retorna o CLSID do original (objetoclsidOld).

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	objbase.h
Library	ole32.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

COM Functions