IMsgStore::SetReceiveFolder
Aplica-se a: Outlook 2013 | Outlook 2016
Estabelece uma pasta como o destino para mensagens de entrada de uma classe de mensagem específica.
HRESULT SetReceiveFolder(
LPSTR lpszMessageClass,
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Parâmetros
lpszMessageClass
[in] Um ponteiro para a classe de mensagem que deve ser associada à nova pasta de recebimento. Se o parâmetro lpszMessageClass for definido como NULL ou uma cadeia de caracteres vazia, SetReceiveFolder definirá a pasta de recebimento padrão para o repositório de mensagens.
ulFlags
[in] Um bitmask de sinalizadores que controla o tipo do texto nas cadeias de caracteres passadas. O seguinte sinalizador pode ser definido:
MAPI_UNICODE
A cadeia de caracteres de classe de mensagem está no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, a cadeia de caracteres da classe de mensagem estará no formato ANSI.
cbEntryID
[in] A contagem de bytes no identificador de entrada apontada pelo parâmetro lpEntryID .
Lpentryid
[in] Um ponteiro para o identificador de entrada da pasta para estabelecer como a pasta de recebimento. Se o parâmetro lpEntryID for definido como NULL, SetReceiveFolder substituirá a pasta de recebimento atual pelo padrão do repositório de mensagens.
Valor de retorno
S_OK
Uma pasta de recebimento foi estabelecida com êxito.
Comentários
O método IMsgStore::SetReceiveFolder define ou altera a pasta de recebimento de uma classe de mensagem específica. Com SetReceiveFolder, um cliente pode, usando chamadas sucessivas, especificar uma pasta de recebimento diferente para cada classe de mensagem definida ou especificar que as mensagens de entrada para várias classes de mensagem vão todas para a mesma pasta. Por exemplo, um cliente pode ter sua própria classe de mensagens chegando em sua própria pasta. Um aplicativo de fax pode designar uma pasta na qual o provedor da loja coloca faxes de entrada e outra pasta na qual o provedor coloca faxes de saída.
Se ocorrer um erro durante a chamada para SetReceiveFolder, a configuração da pasta de recebimento permanecerá inalterada.
Se SetReceiveFolder alterar a configuração da pasta de recebimento com lpEntryID definida como NULL, indicando que a pasta de recebimento padrão deve ser definida, SetReceiveFolder retornará S_OK mesmo que não houvesse uma configuração existente para a classe de mensagem indicada.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnSetReceiveFolder |
O MFCMAPI usa o método IMsgStore::SetReceiveFolder para definir uma pasta como a pasta de recebimento para uma classe de mensagem específica. |