Compartilhar via


Função CoGetTreatAsClass (combaseapi.h)

Retorna o CLSID de um objeto que pode emular o objeto especificado.

Sintaxe

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

Parâmetros

[in] clsidOld

O CLSID do objeto que pode ser emulado (tratado como) um objeto com um CLSID diferente.

[out] pClsidNew

Um ponteiro para onde o CLSID que pode emular objetos clsidOld é recuperado. Esse parâmetro não pode ser NULL. Se não houver informações de emulação para objetos clsidOld , o parâmetro clsidOld será fornecido.

Retornar valor

Essa função pode retornar os valores a seguir, bem como quaisquer valores de erro retornados pela função CLSIDFromString .

Código de retorno Descrição
S_OK
Um novo CLSID foi retornado com êxito.
S_FALSE
Não há informações de emulação para o parâmetro clsidOld , portanto, o parâmetro pClsidNew é definido como clsidOld.
REGDB_E_READREGDB
Erro ao ler o registro.

Comentários

CoGetTreatAsClass retorna a entrada TreatAs no registro para o objeto especificado. A entrada TreatAs , se definida, é o CLSID de um objeto registrado (um aplicativo) que pode emular o objeto em questão. A entrada TreatAs é definida por meio de uma chamada para a função CoTreatAsClass . A emulação permite que um aplicativo abra e edite um objeto de um formato diferente, mantendo o formato original do objeto. Objetos do CLSID original são ativados e tratados como objetos do segundo CLSID. Quando o objeto é salvo, isso pode resultar em perda de edições sem suporte no formato original. Se não houver nenhuma entrada TreatAs para o objeto especificado, essa função retornará o CLSID do objeto original (clsidOld).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho combaseapi.h (inclua Objbase.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

Cotreatasclass