HOWTO: Retrieve Alternate E-mail Addresses Using Extended MAPI

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

SUMMARY

This article contains an Extended MAPI code sample that demonstrates how to access the PR_EMS_AB_PROXY_ADDRESSES property of the Mail-Recipient object. This multi-valued property contains the foreign system e-mail addresses (alternate e-mail addresses).

MORE INFORMATION

Microsoft Exchange Server supports the following types of addresses:

• Exchange



• Microsoft Mail



• Mac Mail



• X.400



• Internet(SMTP)



• Lotus cc:Mail



• Custom

Sample Code

#include <stdio.h>
#include "mapiutil.h"
#include "emsabtag.h"

void main()
{
	HRESULT			hr = S_OK;
	LPMAPISESSION		lpSession = NULL;
	LPADRBOOK			lpAddrbk = NULL;

	ULONG			cbEID = 0L;
	LPBYTE			lpEID = NULL;
	LPADRLIST			pAdrList = NULL;

	SBinary			sBin;
	ULONG			cValues = 0;
	ULONG			ulObjType = NULL;
	LPMAILUSER		pMailUser = NULL;
	LPSPropValue		lpPropValue = NULL;
	ULONG			i, j;

	SizedSPropTagArray(1, sptOneItem) = {1, PR_EMS_AB_PROXY_ADDRESSES};

	// replace with a user's alias or display name
	char* lpszDisplayName = "Alias";

	// Initialize MAPI Subsystem
	hr = MAPIInitialize(NULL);
	if (S_OK != hr) return;

	// Logon to MAPI
	hr = MAPILogonEx(0,
			NULL,
			NULL,
			MAPI_LOGON_UI | MAPI_NEW_SESSION,
			&lpSession);
	if (FAILED(hr)) goto UnInit;

	hr = lpSession->OpenAddressBook(0,NULL,0,&lpAddrbk);
	if (FAILED(hr)) goto Cleanup0;

	// resolve name
	// Allocate memory for new SRowSet structure.
	hr = MAPIAllocateBuffer(CbNewSRowSet(1),(LPVOID*) &pAdrList);
	if (FAILED(hr)) goto Cleanup0;
		
	// Zero out allocated memory.
	ZeroMemory ( pAdrList, CbNewSRowSet(1));

	hr = MAPIAllocateBuffer(7 * sizeof(SPropValue),
			(LPVOID FAR *)&(pAdrList->aEntries[0].rgPropVals));
	if (FAILED(hr)) goto Cleanup;

	// Zero out allocated memory.
	ZeroMemory ( pAdrList -> aEntries[0].rgPropVals,
			7 * sizeof(SPropValue) );

	// How many recipients to resolve.
	pAdrList->cEntries = 1;
	pAdrList->aEntries[0].cValues = 2L;

	pAdrList->aEntries[0].rgPropVals[0].ulPropTag = PR_DISPLAY_NAME;
	pAdrList->aEntries[0].rgPropVals[0].Value.lpszA =  lpszDisplayName;
	pAdrList->aEntries[0].rgPropVals[1].ulPropTag = PR_ADDRTYPE;
	pAdrList->aEntries[0].rgPropVals[1].Value.lpszA = "SMTP";

	hr = lpAddrbk -> ResolveName (0L, 0L, NULL, pAdrList );
	if (FAILED(hr)) goto Cleanup;
   
	for (i = 0; i < 7; ++i)
	{
	   // look for entry id
	   if (pAdrList->aEntries[0].rgPropVals[i].ulPropTag == PR_ENTRYID) 
	   {
			printf("EntryID: %u\n", pAdrList->aEntries[0].rgPropVals[i].Value.ul);
			
			sBin.cb = pAdrList->aEntries[0].rgPropVals[i].Value.bin.cb;
			sBin.lpb = pAdrList->aEntries[0].rgPropVals[i].Value.bin.lpb;

			hr = lpAddrbk->OpenEntry(sBin.cb,
						(LPENTRYID)sBin.lpb,
						NULL, 
						0,
						&ulObjType,
						(LPUNKNOWN*)&pMailUser);
			if (FAILED(hr)) goto Cleanup;

			hr = pMailUser->GetProps((LPSPropTagArray)&sptOneItem,
		                                 0, 
		                                 &cValues,
		                                 &lpPropValue);
			
			if (hr & MAPI_W_ERRORS_RETURNED)
			{
				printf("Warning in GetProps...\n");
				goto Cleanup;
			}

			if (HR_FAILED(hr))
			{
				printf("GetProps failed...\n");
				goto Cleanup;
			}
			// loop through the proxy multivalue property
			for (j = 0; j < lpPropValue->Value.MVszA.cValues; j++)
			{
				printf("%s\n", lpPropValue->Value.MVszA.lppszA[j]);
			}

	   }
	}

Cleanup:
	MAPIFreeBuffer((LPVOID)pAdrList);
Cleanup0:
	if (pMailUser) pMailUser->Release();
	if (lpAddrbk) lpAddrbk->Release();
	lpSession->Logoff(0, 0, 0);
	if (lpSession) lpSession->Release();
UnInit:
	MAPIUninitialize();
} 

REFERENCES

For information on alternate e-mail addresses supported by Microsoft Exchange Server and how to retrieve the PR_EMS_AB_PROXY_ADDRESSES property using Collaboration Data Objects (CDO), please refer to the following article in the Knowledge Base:

Q196507 HOWTO: Retrieve Alternate E-mail Addresses Using CDO

Additional query words:

Keywords : kbMAPI kbMsg kbVC kbVC600 kbMAPI100 kbGrpMsg kbDSupport
Version : WINDOWS:1.0
Platform : WINDOWS
Issue type : kbhowto