Propriedade Canônica PidTagMessageStatus
Aplica-se a: Outlook 2013 | Outlook 2016
Contém uma máscara de bits de 32 bits de sinalizadores que define o status de uma mensagem em uma tabela de conteúdo.
| Propriedade | Valor |
|---|---|
| Propriedades associadas: |
PR_MSG_STATUS |
| Identificador: |
0x0E17 |
| Tipo de dados: |
PT_LONG |
| Área: |
Envio de mensagens gerais |
Comentários
Uma mensagem pode existir em uma tabela de conteúdo e em uma ou mais tabelas de resultados de pesquisa, e cada instância da mensagem pode ter uma status diferente. Essa propriedade não deve ser considerada uma propriedade em uma mensagem, mas uma coluna em uma tabela de conteúdo.
Um aplicativo cliente pode definir um ou mais dos seguintes sinalizadores nesta propriedade:
MSGSTATUS_ANSWERED
A mensagem foi respondida.
MSGSTATUS_DELMARKED
A mensagem foi marcada para exclusão subsequente.
MSGSTATUS_DRAFT
A mensagem está em status de revisão de rascunho.
MSGSTATUS_HIDDEN
A mensagem deve ser suprimida das exibições da pasta dos destinatários.
MSGSTATUS_HIGHLIGHTED
A mensagem deve ser realçada nas exibições da pasta dos destinatários.
MSGSTATUS_REMOTE_DELETE
A mensagem foi marcada para exclusão no repositório de mensagens remotas sem baixar para o cliente local.
MSGSTATUS_REMOTE_DOWNLOAD
A mensagem foi marcada para download do repositório de mensagens remoto para o cliente local.
MSGSTATUS_TAGGED
A mensagem foi marcada para uma finalidade definida pelo cliente.
Os sinalizadores MSGSTATUS_DELMARKED, MSGSTATUS_HIDDEN, MSGSTATUS_HIGHLIGHTED e MSGSTATUS_TAGGED são definidos pelo cliente. Os provedores de transporte e armazenamento passam esses bits sem nenhuma ação.
Os clientes podem interpretar esses valores de qualquer maneira apropriada para seus aplicativos. Uma maneira de muitos clientes usarem essa propriedade é exibir mensagens marcadas para exclusão com um ícone representativo.
Um cliente de visualizador remoto pode definir MSGSTATUS_REMOTE_DELETE ou MSGSTATUS_REMOTE_DOWNLOAD em mensagens na pasta cabeçalho apresentada a ele pelo provedor de transporte remoto. O aplicativo cliente pode examinar cada cabeçalho de mensagem nesta pasta para determinar se a mensagem deve ser baixada ou excluída no repositório de mensagens remotas. Em seguida, ele usa o método IMAPIFolder::SetMessageStatus para definir o sinalizador apropriado. SetMessageStatus é a única maneira de definir qualquer um dos sinalizadores nesta propriedade; O método IMAPIProp::SetProps não pode ser usado. Para recuperar essa propriedade, os clientes chamam IMAPIFolder::GetMessageStatus em vez de IMAPIProp::GetProps.
Os bits 16 a 31 (0x10000 por 0x80000000) dessa propriedade estão disponíveis para uso pelo aplicativo cliente IPM (mensagem interpessoal). Todos os outros bits são reservados para uso pelo MAPI; aqueles não definidos na tabela anterior devem ser inicialmente definidos como zero e não alterados posteriormente.
Recursos relacionados
Especificações de protocolo
Fornece referências às especificações de protocolo Exchange Server relacionadas.
Manipula a sincronização de dados de objeto de mensagens entre um servidor e um cliente.
Arquivos de cabeçalho
Mapidefs.h
Fornece definições de tipo de dados.
Mapitags.h
Contém definições de propriedades listadas como nomes alternativos.