mapi_get_property_sz_ex

Example: mapi_get_property_sz_ex MS Exchange Server Functions (MAPI)

Obtains a MAPI property for a specific session.

char *mapi_get_property_sz_ex( MAPI *ppmapi, char *property );
ppmapi A session identifier.
property The MAPI property to retrieve. One of the supported MAPI Properties.

The mapi_get_property_sz_ex function retrieves the value of the requested MAPI property for the current message in a specific session and returns a pointer to the buffer containing the value.

mapi_get_property_sz_ex allocates storage for the buffer.

This function is for use with multiple sessions. For global sessions, use the mapi_get_property_sz function, which leaves out the session identifier.

mapi_get_property_sz_ex is called after mapi_read_next_mail_ex which saves the body of the current message to the Content property using the "Save=body" option.

Return Values

If this function succeeds, it returns the value of the specified property. Otherwise, it returns an empty string.

Parameterization

All arguments of this function of the type char, can be parameterized with standard parameterization.