Função OleGetAutoConvert (ole2.h)
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 |
|---|---|
|
Um valor foi retornado com êxito por meio do parâmetro pclsidNew . |
|
O CLSID não está registrado corretamente no registro. |
|
Erro ao ler do registro. |
|
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) |