IMessage

9/8/2008

The IMessage interface gerencia as mensagens, anexos e destinatários.

Métodos na ordem TabelaV

• IUnknown métodos
• IMAPIProp métodos

Métodos IMessage	Description
IMessage::GetAttachmentTable	Retorna anexo IMAPITable objeto a mensagem.
IMessage::OpenAttach	Abre um objeto IAttach.
IMessage::CreateAttach	Cria um novo objeto IAttach.
IMessage::DeleteAttach	Exclui um objeto IAttach.
IMessage::GetRecipientTable	Retorna objeto a mensagem destinatário IMAPITable.
IMessage::ModifyRecipients	Adiciona, exclui e modifica lista de uma mensagem de destinatários, que está contida em uma estrutura ADRLIST.
IMessage::SubmitMessage	Salva todas as alterações para a mensagem e marca como pronto para envio.
IMessage::SetReadFlag	Não com suporte — não são usados.

Propriedades

As propriedades listadas na seguinte tabela são exigido em mensagens em alguns apontar durante suas ciclo de vida. As propriedades somente leitura são definidas pelo provedor de transporte.

Propriedades necessárias para mensagens de todas as classes	Acesso
PR_ENTRYID	Somente leitura
PR_LAST_MODIFICATION_TIME	Somente leitura
PR_MESSAGE_CLASS	Leitura/gravação
PR_MESSAGE_FLAGS	Leitura/gravação
PR_MESSAGE_SIZE	Somente leitura
PR_PARENT_ENTRYID	Somente leitura
PR_RECIPIENT_TYPE	Somente leitura
PR_SENDER_EMAIL_ADDRESS	Somente leitura
PR_SENDER_NAME	Somente leitura

As propriedades listadas no seguinte tabelas são somente leitura aos clientes, com a exceção de PR_BODY. Construção clientes essa propriedade quando eles processo um relatório.

Propriedades de mensagens relatório	Acesso
PR_BODY	Leitura/gravação
PR_MESSAGE_CLASS	Somente leitura
PR_MESSAGE_DELIVERY_TIME	Somente leitura
PR_SENDER_EMAIL_ADDRESS	Somente leitura
PR_SENDER_NAME	Somente leitura
PR_SUBJECT	Somente leitura

Propriedades de mensagem destinatários	Acesso	Necessário ou opcional
PR_ADDRTYPE	Somente leitura	Necessários
PR_EMAIL_ADDRESS	Somente leitura	Opcional
PR_ENTRYID	Somente leitura	Necessários

Remarks

IMessage é implementada por provedores de armazenamento de mensagens, é chamado pelos aplicativos Message Client e é exposta pelos objetos IMessage.

The IMessage identificador interface é IID_Message, e é seu tipo ponteiro LPMESSAGE.

Exemplo de código

O seguinte exemplo de código demonstra como usar IMAPIProp::GetProps, que IMessage herda de IMAPIProp.

Observação

Para tornar o exemplo de código mais fácil para ler, verificação de segurança e manipulação de erro não estão incluídos.This code example should not be used in a release configuration unless it has been modified to include them.

HRESULT GetPropsExample(IMessage * pMsg) 
{
    HRESULT           hr = E_FAIL;
    SPropValue * rgprops = NULL;
    ULONG       rgTags[] = {3, PR_SENDER_EMAIL_ADDRESS, PR_SUBJECT, PR_IMPORTANCE};
    ULONG         cCount = 0;

    // Get the message's properties.
    hr = pMsg->GetProps((LPSPropTagArray) rgTags, MAPI_UNICODE, &cCount, &rgprops);

    // Access the properties.
    if (SUCCEEDED(hr)) 
    {        
        // Check that the ulPropTag member of each property value is of the property type requested, and that it does not have a value of PT_ERROR.
        if (rgprops[0].ulPropTag == PR_SENDER_EMAIL_ADDRESS) 
            DEBUGMSG(TRUE, (L"From: %s \r\n", rgprops[0].Value.lpszW));

        if (rgprops[1].ulPropTag == PR_SUBJECT) 
            DEBUGMSG(TRUE, (L"Subject: %s \r\n", rgprops[1].Value.lpszW));

        if (rgprops[2].ulPropTag == PR_IMPORTANCE) 
            DEBUGMSG(TRUE, (L"Importance: %d \r\n", rgprops[2].Value.ul));
        
        // Free the returned SPropValue structure.
        MAPIFreeBuffer(rgprops);
    }

    return hr;
}

Requisitos

Header	mapidefs.h
Library	cemapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Other Resources

MAPI Interfaces
Messaging