Pastas de recebimento MAPI

Aplica-se a: Outlook 2013 | Outlook 2016

Uma pasta de recebimento contém mensagens de entrada de uma determinada classe de mensagem. As associações de pasta de recebimento podem ser estabelecidas pelos clientes, pelo provedor do repositório de mensagens ou pelo MAPI. O MAPI tem duas pastas de recebimento padrão: a pasta raiz do repositório de mensagens e a pasta Caixa de Entrada da subárvore de mensagens interpessoais (IPM). A pasta raiz do repositório de mensagens é a pasta de recebimento padrão para todas as mensagens IPC (comunicação entre processos).

A pasta Caixa de Entrada é criada pelo MAPI para cada novo repositório de mensagens e atua como a pasta de recebimento padrão para as seguintes classes de mensagens:

  • A classe de mensagem IPM.

  • A classe de mensagem de relatório.

  • Uma classe vazia ou ausente.

Todas as mensagens de relatório, mesmo aquelas enviadas em resposta a uma mensagem IPC, são colocadas na pasta Caixa de Entrada. Os aplicativos cliente IPC que processam seus próprios relatórios devem adicionar explicitamente uma pasta de recebimento para a classe específica de relatório. Por exemplo, se um cliente espera receber mensagens com a classe IPC. Paper.Order, ele deve chamar o método IMsgStore::SetReceiveFolder para estabelecer uma pasta de recebimento para relatórios com a classe Report.IPC.Paper.Order.

As associações de pasta de recebimento são baseadas na organização hierárquica de classes de mensagens. Os clientes podem estabelecer explicitamente uma associação entre uma pasta de recebimento e uma classe de mensagem ou usar as pastas de recebimento padrão MAPI. Normalmente, os clientes designam uma pasta para receber mensagens para uma classe base e todas as suas subclasses. Por exemplo, um cliente típico estabeleceria uma associação para mensagens com a classe MyClass. Então, se o cliente recebesse mensagens com as classes MyClass.Home ou MyClass.Home.Kitchen.Computer, essas mensagens iriam para a pasta de recebimento da classe base, MyClass.

Existem três métodos de repositório de mensagens que os clientes usam para trabalhar com pastas de recebimento:

A tabela de pastas de recebimento é uma listagem de informações sobre todas as pastas de recebimento estabelecidas para um armazenamento de mensagens. Seu conjunto de colunas necessário inclui a classe da mensagem, a chave de registro e o identificador de entrada.

Para recuperar uma pasta de recebimento para uma determinada classe de mensagem, os clientes passam a cadeia de caracteres da classe de mensagem para o método IMsgStore::GetReceiveFolder . O provedor de repositório de mensagens retorna um identificador de entrada para a pasta correspondente. Para implementar GetReceiveFolder, um provedor de repositório de mensagens deve usar um algoritmo que seleciona a pasta cuja classe de mensagem associada corresponde ao prefixo mais longo possível da classe de mensagem especificada. Por exemplo, suponha que o repositório de mensagens tenha as seguintes associações entre pastas de recebimento e classes de mensagens em sua tabela de pastas de recebimento:

  • As mensagens IPM são colocadas na pasta Caixa de Entrada.

  • IPM. Observação. As mensagens de amostra são colocadas na pasta Amostras.

A tabela a seguir mostra como as mensagens com várias classes seriam roteadas para a pasta de recebimento apropriada.

Classe de mensagem de entrada Pasta de recebimento
IPM. Note.Sample.Simple
Pasta Samples
IPM. Observação
Pasta da caixa de entrada
IPM. Cartão de ponto
Pasta da caixa de entrada
IPM. Note.Sample.Simple.Totally
Pasta Samples

Os clientes chamam o método SetReceiveFolder para fazer uma associação explícita entre uma determinada classe de mensagem e a pasta de recebimento. Quando uma mensagem é entregue a uma classe de mensagem vazia, o MAPI coloca a mensagem na pasta de recebimento definida para um prefixo da classe vazia. Por exemplo, se o seu cliente tiver uma pasta de recebimento estabelecida para mensagens com classe IPM e uma mensagem com classe IPM. Note.Test for delivered, esta mensagem será colocada na pasta de recebimento para a classe de mensagem IPM .

Ao chamar SetReceiveFolder, os clientes normalmente passam uma cadeia de caracteres de classe de mensagem e o identificador de entrada da nova pasta de recebimento. No entanto, os clientes podem passar NULL para um ou ambos os parâmetros. A tabela a seguir descreve o comportamento resultante da especificação de NULL para os parâmetros do identificador de entrada e classe de mensagem.

Parâmetro SetReceiveFolder Comportamento resultante
Identificador de entrada definido como NULL
O repositório de mensagens exclui a associação entre a classe de mensagem especificada e sua pasta de recebimento existente. Uma nova pasta de recebimento não foi estabelecida. As chamadas subsequentes para GetReceiveFolder com essa classe de mensagem retornarão a pasta de recebimento para um prefixo da classe de mensagem; para novos armazenamentos de mensagens, GetReceiveFolder retornará a Caixa de Entrada na subárvore IPM.
Classe de mensagem definida como NULL
O repositório de mensagens altera a associação da classe de mensagem vazia para a pasta indicada. As mensagens de entrada cuja classe não é reconhecida irão para essa pasta.
Identificador de entrada e classe de mensagem definidos como NULL
O repositório de mensagens exclui a associação de classe/pasta para a classe de mensagem vazia. Você não deve definir os dois parâmetros como NULL, pois isso geralmente resulta em mensagens de entrada sendo colocadas na pasta raiz do repositório de mensagens, uma pasta invisível para o cliente.

Embora a classe de uma mensagem nunca deva estar vazia, uma classe de mensagem vazia pode ocorrer. É responsabilidade do repositório de mensagens atribuir a classe de mensagem ao IPM para novas mensagens de saída que tenham uma classe vazia; é responsabilidade do provedor de transporte atribuir o IPM. Anote como a classe para mensagens de entrada que têm qualquer classe vazia.

Confira também

Pastas MAPI