Função GetConvertStg (coml2api.h)

A função GetConvertStg retorna o valor atual do bit de conversão para o objeto de armazenamento especificado.

Sintaxe

HRESULT GetConvertStg(
  [in] LPSTORAGE pStg
);

Parâmetros

[in] pStg

Ponteiro IStorage para o objeto de armazenamento do qual o bit de conversão deve ser recuperado.

Retornar valor

IStorage::OpenStream, IStorage::OpenStorage e ISequentialStream::Ler erros de acesso de fluxo e armazenamento.

Comentários

A função GetConvertStg é chamada por servidores de objetos que dão suporte à conversão de um objeto de um formato para outro. O servidor deve ser capaz de ler o objeto de armazenamento usando o formato de seu CLSID (identificador de classe anterior) e gravar o objeto usando o formato de seu novo CLSID para dar suporte à conversão do objeto. Por exemplo, uma planilha criada por um aplicativo pode ser convertida no formato usado por um aplicativo diferente.

O bit de conversão é definido por uma chamada para a função SetConvertStg . Um aplicativo de contêiner pode chamar essa função na solicitação de um usuário final ou um programa de instalação pode chamá-la ao instalar uma nova versão de um aplicativo. Um usuário final solicita a conversão de um objeto por meio da caixa de diálogo Converter para . Quando um objeto é convertido, o novo CLSID é atribuído permanentemente ao objeto , portanto, o objeto é associado posteriormente ao novo CLSID.

Em seguida, quando o objeto é ativado, seu servidor chama a função GetConvertStg para recuperar o valor do bit de conversão do objeto de armazenamento. Se o bit estiver definido, o CLSID do objeto será alterado e o servidor deverá ler o formato antigo e gravar o novo formato para o objeto de armazenamento.

Depois de recuperar o valor de bit, o aplicativo objeto deve limpar o bit de conversão chamando a função SetConvertStg com seu parâmetro fConvert definido como FALSE.

Requisitos

Confira também

SetConvertStg