Função OleGetAutoConvert (ole2.h)

  • Artigo

Determina se o registro está definido para que objetos de um CLSID especificado sejam convertidos automaticamente em outro CLSID e, nesse caso, recupera o novo CLSID.

Sintaxe

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

Parâmetros

[in] clsidOld

O CLSID para o objeto .

[out] pClsidNew

Um ponteiro para uma variável para receber o novo CLSID, se houver. Se a conversão automática para clsidOld não estiver definida no registro, clsidOld será retornado. O parâmetro pClsidNew nunca é NULL.

Retornar valor

Essa função pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 Um valor foi retornado com êxito por meio do parâmetro pclsidNew .
REGDB_E_CLASSNOTREG
 O CLSID não está registrado corretamente no registro.
REGDB_E_READREGDB
 Erro ao ler do registro.
REGDB_E_KEYMISSING
 A conversão automática não está ativa ou não houve nenhuma entrada do Registro para o parâmetro clsidOld .

Comentários

OleGetAutoConvert retorna a entrada AutoConvertTo no registro do objeto especificado. A subchave AutoConvertTo especifica se os objetos de um determinado CLSID devem ser convertidos automaticamente em um novo CLSID. Isso geralmente é usado para converter arquivos criados por versões mais antigas de um aplicativo para a versão atual. Se não houver nenhuma entrada AutoConvertTo , essa função retornará o valor de clsidOld.

A função OleDoAutoConvert chama OleGetAutoConvert para determinar se o objeto especificado deve ser convertido. Um aplicativo de contêiner que dá suporte à conversão de objeto deve chamar OleDoAutoConvert sempre que carregar um objeto. Se o contêiner usar a função auxiliar OleLoad , ele não precisará chamar OleDoAutoConvert explicitamente porque OleLoad a chama internamente.

Para configurar a conversão automática de uma determinada classe, você pode chamar a função OleSetAutoConvert (normalmente no programa de instalação de uma instalação de aplicativo). Essa função usa a subchave AutoConvertTo para marcar uma classe de objetos para conversão automática em uma classe diferente de objetos. Essa é uma subchave da chave CLSID.

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 ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-0 (introduzido em Windows 8)

Confira também

AutoConvertTo

OleDoAutoConvert

OleSetAutoConvert