HOWTO: Customizing the Reply To Property for a Message

• Extended Messaging Application Programming Interface (MAPI), version 1.0

SUMMARY

There may be times when you want to force the reply of a message to a particular person or distribution list. You can accomplish this by using the PR_REPLY_RECIPIENT_NAMES property of the message.

MORE INFORMATION

You can set the PR_REPLY_RECIPIENT_NAMES property by using code. It should be noted that the code sample below is not a complete working program and it assumes that you have a handle to a MAPI session.

1. Add the PR_REPLY_RECIPIENT_NAMES to the SPropValue array.

        pspvOut[OBSENTREP].ulPropTag = PR_REPLY_RECIPIENT_NAMES;
   

2. Set the value of the PR_REPLY_RECIPIENT_NAMES property. This property will contain the Display Name of the recipients.

        pspvOut[OBSENTREP].Value.lpszA = "[SMTP:testing@Microsoft.com]";
   

3. Create an ADRLIST structure containing the address or addresses to reply to.

   NAME, ADDR, EMAIL, RECIP are part of an enum of the recipient properties.

         LPADRLIST  pAdrList = NULL;
         if (FAILED(hRes = MAPIAllocateBuffer(CbNewSRowSet(1),
                                             (LPVOID*) &pAdrList)))
             goto Quit;
   
         if (FAILED(hRes = MAPIAllocateBuffer(
                  NUM_RECIP_PROPS * sizeof(SPropValue),
                 (LPVOID*) &(pAdrList->aEntries[0].rgPropVals) )))
             goto Quit;
   
         pAdrList->cEntries = 1;
         pAdrList->aEntries[0].cValues = 4;
         pAdrList->aEntries[0].rgPropVals[NAME].ulPropTag = PR_DISPLAY_NAME;
         pAdrList->aEntries[0].rgPropVals[NAME].Value.lpszA="Test User";
         pAdrList->aEntries[0].rgPropVals[ADDR].ulPropTag = PR_ADDRTYPE;
         pAdrList->aEntries[0].rgPropVals[ADDR].Value.lpszA = "SMTP";
         pAdrList->aEntries[0].rgPropVals[EMAIL].ulPropTag = PR_EMAIL_ADDRESS;
         pAdrList->aEntries[0].rgPropVals[EMAIL].Value.lpszA = "";
         pAdrList->aEntries[0].rgPropVals[RECIP].ulPropTag =
                PR_RECIPIENT_TYPE;
         pAdrList->aEntries[0].rgPropVals[RECIP].Value.l = MAPI_TO;
   
   

4. Call ResolveName to get ENTRYIDs for the addresses.

         hRes = m_pAddrBook->ResolveName(NULL,MAPI_DIALOG,
                                         "Resolve Names",pAdrList);
   
   

5. Set the properties of the outbound message.

         if (FAILED(hRes = pMsg ->
             SetProps(NUM_OUTBOUND_PROPS,pspvOut,&pPropProblemArray)))
           goto Quit;
   
         hRes = pMsg -> ModifyRecipients(0,pAdrList);
   
   

REFERENCES