C++ MAPI: how to define named properties corresponding with a contact's email address?

Question

I'm trying to convert a Microsoft.Graph.Contact object into a PST file for Outlook using Extended MAPI, and I don't know where to feed the contact's email addresses to and have it show when I open the contact in Outlook, and wanted to know how I can do that with Microsoft's MAPI SDK.

EDIT: I managed to create the new property

const GUID PSETID_Address = {0x00062004, 0, 0, {0xC0, 0, 0, 0, 0, 0, 0, 0x46}};


LPSPropTagArray cols = NULL;

MAPINAMEID  sa = {
  (LPGUID) &PSETID_Address,
  MNID_ID,
  0x8083
};

LPMAPINAMEID sample = {
  &sa
};

hr = obj->GetIDsFromNames(1, &sample, MAPI_CREATE, &cols);

SPropValue values[1];
//I'm setting other contact fields. This code is just for brevity. (There's more than 1 property)
values[0].ulPropTag = PROP_TAG(PT_UNICODE, cols->aulPropTag[0]);
values[0].Value.lpszW = L"[email protected]";
LPSPropProblemArray problems = NULL;
hr = obj->SetProps(1, values, &problems);

SetProps then fails with "The parameter is not correct." What am I doing wrong here?

Dmitry Streblechenko · Accepted Answer · 2025-09-04 21:07:57Z

6

Email1 is in {00062004-0000-0000-C000-000000000046} / 0x8083 / PT_UNICODE.
You can see that (and all other) properties in OutlookSpy (I am its author):

answered Sep 4 at 21:07

Dmitry Streblechenko

67.1k4 gold badges56 silver badges84 bronze badges

Sign up to request clarification or add additional context in comments.

11 Comments

Tyler McCall Sep 4 at 22:42

Thanks, but do you know how to create this object in c++?

Dmitry Streblechenko Sep 4 at 23:34

Sure, first you open/create the PST store, open the IPM root folder, create your contacts folder (IMAPIFolder.CreateFolder), then IMessage (IMAPIFolder.CreateMessage), etc. If you've never done Extended MAPI, the learning curve is pretty steep. Have you looked into Redemption (I am also its author)? It similar to the Outlook Object Model, but allows you to work with PST files without adding them to an Outlook profile (RDOSession.LogonPstStore) and can be used without any user interaction as long as the MAPI system (and hence desktop Outlook) is installed.

Tyler McCall Sep 5 at 0:28

thanks for the heads up on SAPI. Certainly the errors returned do not help in the slightest.

Dmitry Streblechenko Sep 5 at 1:59

ulKind needs to be MNID_ID, the id must be 0x8083.

Dmitry Streblechenko Sep 5 at 2:01

Also keep in mind that for Outlook to see and use the email, you need to set a few more properties (entry id, display name, etc.) - take a look at IMessage in OuitlookSpy.

Tyler McCall Sep 8 at 21:02

I've set the ulKind to MNID_ID with the value of 0x8083. Am I coming at this wrong? It still gives me "The Parameter is not correct" HR code -2147024809. Even gone so far as to try to look at what's coming back for property problems but it remains NULL.

Tyler McCall Sep 8 at 23:56

Ended up solving it by calling CHANGE_PROP_TYPE() instead of PROP_TAG which I didn't know existed until now. Thank you for your help.

Dmitry Streblechenko Sep 9 at 2:17

Ah, yes, one assumes 2 byte prop and shift the value up by 16 bits, the other only changes the lower 16 bits to set the type.

Remy Lebeau Sep 4 at 22:57

{00062004-0000-0000-C000-000000000046} is also known as PSETID_Address, see Commonly used property sets

Tyler McCall Sep 5 at 0:25

Thank you so much for that. That helped get me on the right track. One more question and that's on the edit.

Remy Lebeau Sep 5 at 4:02

Your code doesn't compile as you can't assign a string literal to a LONG. You need to use Kind.lpwstrName instead of Kind.lID. Also, you are not checking GetIDsOfNames() for failure, and you are ignoring the output info provided by the lppProblems parameter of SetProps()

Collectives™ on Stack Overflow

C++ MAPI: how to define named properties corresponding with a contact's email address?

1 Answer 1

11 Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

11 Comments

Your Answer

Sign up or log in

Post as a guest

Related