Criando e salvando dados para armazenamento de soluções

Este tópico descreve como criar ou usar o repositório existente para guardar dados particulares de solução.

O modelo de objeto do Outlook permite criar e armazenar dados de solução como itens ocultos em uma pasta. Use Folder.GetStorage para criar um objeto StorageItem em uma pasta especificada. É possível identificar esse objeto por assunto, classe de mensagem ou identificação de entrada. As soluções podem criar objetos StorageItem em todas as pastas, exceto quando:

• A pasta é uma pasta pública do Microsoft Exchange, um Protocolo de Acesso a Mensagens da Internet (IMAP), o MsN Hotmail ou uma pasta do Microsoft SharePoint Foundation.

• A permissão do usuário para a pasta é somente leitura.

• O provedor de repositório não oferece suporte a itens ocultos.

Nesses casos, Folder.GetStorage retornará um erro: "Não é possível criar StorageItem nesta pasta". Quando você chama Folder.GetStorage especificando um assunto ou uma classe de mensagem e o item especificado não existe na pasta, a chamada cria e retorna um objeto StorageItem com a classe de mensagem IPM. Armazenamento; se você especificou uma ID de Entrada, no entanto, a chamada retornará o erro: "A operação falhou. Não foi possível localizar um objeto".

Obtendo um StorageItem existente

Você pode chamar Folder.GetStorage de um item que já exista em uma pasta. Por exemplo, o item pode ser um que a solução criou anteriormente; pode ser um item com uma classe de mensagem conhecida, como IPC.MS.Outlook.AgingProperties, ou um item que existia como uma mensagem oculta na pasta em uma versão anterior do Outlook. Nesse caso, a chamada retornará um objeto StorageItem representando o item. No entanto, a classe de mensagem do item não será alterada.

Se você chamar Folder.GetStorage especificando um assunto ou uma classe de mensagem e houver mais de um item na pasta, a chamada retornará o item que foi modificado por último (ou seja, o item com a PidTagLastModificationTime mais recente).

Armazenando dados em um StorageItem

Depois de obter um objeto StorageItem, você pode armazenar dados particulares como um anexo ao item, como um valor da propriedade Body ou como uma propriedade personalizada do item. O tamanho inicial do item é 0. À medida que você armazena dados no item, o StorageItem.Size é atualizado. Chame StorageItem.Save para atualizar o conteúdo do item na pasta.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.