HOWTO: How to Modify Recipient's Alias Through Extended MAPI
ID: Q183249
|
The information in this article applies to:
-
Exchange Development Kit (EDK), versions 5.0, 5.5
-
Extended Messaging Application Programming Interface (MAPI), version 1.0
SUMMARY
This article explains how to programmatically modify the alias attribute of
a Microsoft Exchange Server recipient using Extended Messaging Application
Programming Interface (MAPI) and Exchange Developers Kit (EDK) calls.
MORE INFORMATION
The code below demonstrates step-by-step how to accomplish the task. After
getting a valid session and getting the address book, you open the entry
with the MAPI_MODIFY flag. After that, you get the attributes and search
through them looking for the one you want to change; in this case the
recipient's alias 0x3A00001E. Once found, you modify and save the change.
Step-by-Step Example
Following the steps above you should have the following pseudo-code:
- Initialize MAPI with MAPIInitialize().
- Logon to MAPI with MAPILogonEx().
- Get the address book through IMAPISession::OpenAddressBook().
- "Create" an entryid to the recipient with the EDK function,
HrCreateDirEntryIdEx().
- Open the entry by using the OpenEntry() call.
- Get the attributes with IMAPIProp::GetProps().
- Change the attribute with IMAPIProp::SetProps().
- Save changes using IMAPIProp::SaveChanges().
Sample Code
#include <MAPIUTIL.H>
#include "edkutils.h"
#define FAILURE -1
int main( void )
{
LPADRBOOK lpAdrBook;
LPMAPISESSION pSession = NULL;
HRESULT hRes = 0;
ULONG ulObjType = 0;
LPMAPIPROP lpEntry = NULL;
FLAGS flFlags = MAPI_ALLOW_OTHERS | MAPI_EXTENDED;
ULONG cbeid;
LPENTRYID peid = NULL;
ULONG ulValues;
LPSPropValue pPropValues = NULL;
// Recipient name.
char* szExName ="/o=BIGOPERA/ou=TURANDOT/cn=Recipients/cn=RobertoC";
char* szNewalias = "CarlosA";
// Initialize MAPI.
hRes = MAPIInitialize( NULL );
if ( FAILED( hRes ) )
throw (FAILURE);
// Logon to MAPI.
hRes = MAPILogonEx( 0, "Galileo Galilei", NULL,
flFlags, &pSession );
if ( FAILED( hRes ) )
throw (FAILURE);
// Open the address book.
hRes=pSession->OpenAddressBook(0, 0, MAPI_ACCESS_MODIFY,
&lpAdrBook );
if ( FAILED( hRes ) )
throw (FAILURE);
// Obtain the entry id for the recipient object.
hRes = HrCreateDirEntryIdEx(lpAdrBook, szExName, &cbeid, &peid);
if ( FAILED( hRes ) )
throw (FAILURE);
// Now open the recipient object.
hRes = lpAdrBook->OpenEntry( cbeid, peid, NULL,
MAPI_MODIFY, &ulObjType,
(LPUNKNOWN*) &lpEntry );
if ( FAILED( hRes ) )
throw (FAILURE);
// Get the properties.
hRes = ((IMAPIProp *) lpEntry)->GetProps( NULL,
0,
&ulValues,
&pPropValues );
if ( FAILED( hRes ) )
throw (FAILURE);
// Modify alias name for recipient.
for ( ULONG ul = 0; ul < ulValues; ul++ )
{
if ( 0x3A00001E == pPropValues[ul].ulPropTag )
{
// Modify property.
pPropValues[ul].Value.lpszA = szNewalias;
// Set properties.
hRes = ((IMAPIProp *) lpEntry)->SetProps( 1,
&pPropValues[ul],
NULL );
if ( FAILED( hRes ) )
throw (FAILURE);
// Save changes.
hRes = ((IMAPIProp *) lpEntry)->SaveChanges( 0 );
if ( FAILED( hRes ) )
throw (FAILURE);
break;
}
}
return 0;
}
Additional query words:
Keywords : kbAPI kbEDK kbMsg kbMAPI100 MAPIIAB
Version : WINDOWS:1.0,5.0,5.5
Platform : WINDOWS
Issue type : kbhowto