<html>
<head>
<title>MAPIClientLibraries 0.9 API Documentation</title>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
<link href="apidocs.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="website">
<div class="header"></div>
<div id="middle_side">
<div id="right_side_home">
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<h1>libmapi/mapi_nameid.c File Reference</h1> </div>
</div>
<div class="contents">
<p><a class="el" href="structmapi__nameid.html">mapi_nameid</a> convenience API
<a href="#_details">More...</a></p>
<code>#include <<a class="el" href="libmapi_8h.html">libmapi/libmapi.h</a>></code><br/>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#acdd818c4090d6ea172953f5a97a033f4">mapi_nameid_canonical_add</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, uint32_t proptag)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a16b6f67c39ba6f4464a1f8c4636d95d2">mapi_nameid_custom_lid_add</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, uint16_t lid, uint16_t propType, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a34710e905d2bcf098de2365415453c38">mapi_nameid_custom_string_add</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, const char *Name, uint16_t propType, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a6c24860883850bc1cb7acc5350dc6b4b">mapi_nameid_GetIDsFromNames</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, <a class="el" href="structmapi__object.html">mapi_object_t</a> *obj, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a3410b119334bc8fb8e8019f0127dd5fc">mapi_nameid_lid_add</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, uint16_t lid, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a52592e7a4b3bb08e1f6d9c08ebddede1">mapi_nameid_lid_lookup</a> (uint16_t lid, const char *OLEGUID, uint16_t *propType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#af7418bf978061721530b5f8fb8940694">mapi_nameid_lookup_SPropTagArray</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *nameid, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a9d9381cc7e02705c8e638ada27d6ad57">mapi_nameid_lookup_SPropValue</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, struct SPropValue *lpProps, unsigned long PropCount)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a8662ee1914917df779ebf854361fb0bf">mapi_nameid_map_SPropTagArray</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, struct SPropTagArray *SPropTagArray, struct SPropTagArray *SPropTagArray2)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a6d5e2f646b696da66afcdf6632c293bf">mapi_nameid_map_SPropValue</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, struct SPropValue *lpProps, uint32_t PropCount, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a7705209e3f79f856778b900123159f80">mapi_nameid_new</a> (TALLOC_CTX *mem_ctx)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#aa96315dd49d7670a915e2089a71fa28e">mapi_nameid_OOM_add</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, const char *OOM, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#aa35bf696e4b45822cd834475f03def4c">mapi_nameid_OOM_lookup</a> (const char *OOM, const char *OLEGUID, uint16_t *propType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a69dc7a802ee37eeb57b2bcd0af4f77ff">mapi_nameid_SPropTagArray</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a5ad1d6a8274cef96436cfec5b5d5e102">mapi_nameid_string_add</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, const char *Name, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a877dc914ab217c926f80095862e2e99f">mapi_nameid_string_lookup</a> (const char *Name, const char *OLEGUID, uint16_t *propType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#ad4237bda2484c14ee13fa7f2f5681345">mapi_nameid_unmap_SPropTagArray</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a9429aa3e7cbb75a388fc5b1fc03cbec8">mapi_nameid_unmap_SPropValue</a> (struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> *<a class="el" href="structmapi__nameid.html">mapi_nameid</a>, struct SPropValue *lpProps, uint32_t PropCount)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p><a class="el" href="structmapi__nameid.html">mapi_nameid</a> convenience API </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="acdd818c4090d6ea172953f5a97a033f4"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_canonical_add" ref="acdd818c4090d6ea172953f5a97a033f4" args="(struct mapi_nameid *mapi_nameid, uint32_t proptag)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_canonical_add </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t </td>
<td class="paramname"> <em>proptag</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Add a <a class="el" href="structmapi__nameid.html">mapi_nameid</a> entry given its canonical property tag</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>proptag</em> </td><td>the canonical property tag we are searching</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_NOT_INITIALIZE: MAPI subsystem has not been initialized</li>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
<li>MAPI_E_NOT_FOUND: the entry intended to be added was not found</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#a68f9e170c1dfd3ecbe4e6a58afa54998">mapi_nameid_new</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="structmapi__nameid.html#af801cad10b0bdef13e50aeeab2e8e08f">mapi_nameid::nameid</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
<p>Referenced by <a class="el" href="proto_8h.html#acc75322ecdc6ab1980aaabedc0d66d17">mapi_nameid_lookup_SPropTagArray()</a>, and <a class="el" href="proto_8h.html#a4f0c68e740f1a9ca0165f7294ead11ec">mapi_nameid_lookup_SPropValue()</a>.</p>
</div>
</div>
<a class="anchor" id="a16b6f67c39ba6f4464a1f8c4636d95d2"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_custom_lid_add" ref="a16b6f67c39ba6f4464a1f8c4636d95d2" args="(struct mapi_nameid *mapi_nameid, uint16_t lid, uint16_t propType, const char *OLEGUID)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_custom_lid_add </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t </td>
<td class="paramname"> <em>lid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t </td>
<td class="paramname"> <em>propType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OLEGUID</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Register and add a custom MNID_ID named property given its lid, proptype and OLEGUID.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>lid</em> </td><td>the light ID of the name property (used by MNID_ID named props only) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>propType</em> </td><td>the named property type </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OLEGUID</em> </td><td>the property set this entry belongs to</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
<li>MAPI_E_INVALID_PARAMETER: one of the parameter was no set properly</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#a68f9e170c1dfd3ecbe4e6a58afa54998">mapi_nameid_new</a>, <a class="el" href="proto_8h.html#aea91d7b3f98fd05ec0c47460860e6f54">mapi_nameid_lid_add</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="structmapi__nameid__tags.html#acf5c3305fddfde568d771301ea376fe1">mapi_nameid_tags::lid</a>, <a class="el" href="structmapi__nameid.html#af801cad10b0bdef13e50aeeab2e8e08f">mapi_nameid::nameid</a>, <a class="el" href="structmapi__nameid__tags.html#ae83b1f5261313e1552961600260690d5">mapi_nameid_tags::OLEGUID</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, <a class="el" href="structmapi__nameid__tags.html#ae8e10e9bbbe79d847177ab8336e82980">mapi_nameid_tags::propType</a>, and <a class="el" href="structmapi__nameid__tags.html#a8d855170963801e0df5cc5aad88f5982">mapi_nameid_tags::ulKind</a>.</p>
</div>
</div>
<a class="anchor" id="a34710e905d2bcf098de2365415453c38"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_custom_string_add" ref="a34710e905d2bcf098de2365415453c38" args="(struct mapi_nameid *mapi_nameid, const char *Name, uint16_t propType, const char *OLEGUID)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_custom_string_add </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>Name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t </td>
<td class="paramname"> <em>propType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OLEGUID</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Register and add a custom MNID_STRING named property given its string, proptype and OLEGUID.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>Name</em> </td><td>the property name (used by MNID_STRING named props only) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>propType</em> </td><td>the named property type </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OLEGUID</em> </td><td>the property set this entry belongs to</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
<li>MAPI_E_INVALID_PARAMETER: one of the parameter was not set properly.</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#a68f9e170c1dfd3ecbe4e6a58afa54998">mapi_nameid_new</a>, <a class="el" href="proto_8h.html#ac3e2d267b88359ee287d9df1dae6323c">mapi_nameid_string_add</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="structmapi__nameid__tags.html#a085e34f197d689e2fd248edff6ded203">mapi_nameid_tags::Name</a>, <a class="el" href="structmapi__nameid.html#af801cad10b0bdef13e50aeeab2e8e08f">mapi_nameid::nameid</a>, <a class="el" href="structmapi__nameid__tags.html#ae83b1f5261313e1552961600260690d5">mapi_nameid_tags::OLEGUID</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, <a class="el" href="structmapi__nameid__tags.html#ae8e10e9bbbe79d847177ab8336e82980">mapi_nameid_tags::propType</a>, and <a class="el" href="structmapi__nameid__tags.html#a8d855170963801e0df5cc5aad88f5982">mapi_nameid_tags::ulKind</a>.</p>
</div>
</div>
<a class="anchor" id="a6c24860883850bc1cb7acc5350dc6b4b"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_GetIDsFromNames" ref="a6c24860883850bc1cb7acc5350dc6b4b" args="(struct mapi_nameid *mapi_nameid, mapi_object_t *obj, struct SPropTagArray *SPropTagArray)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_GetIDsFromNames </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> * </td>
<td class="paramname"> <em>obj</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropTagArray * </td>
<td class="paramname"> <em>SPropTagArray</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Lookup named properties (MNID_STRING) and return their mapped proptags</p>
<p>This convenient function calls <a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a> and returns property tags with their real property type.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a>, <a class="el" href="proto_8h.html#a3d563b200503be2d3a63462252372ed2">mapi_nameid_SPropTagArray</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a>, <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a>, <a class="el" href="structmapi__nameid.html#af801cad10b0bdef13e50aeeab2e8e08f">mapi_nameid::nameid</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, and <a class="el" href="structmapi__nameid__tags.html#ae8e10e9bbbe79d847177ab8336e82980">mapi_nameid_tags::propType</a>.</p>
</div>
</div>
<a class="anchor" id="a3410b119334bc8fb8e8019f0127dd5fc"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_lid_add" ref="a3410b119334bc8fb8e8019f0127dd5fc" args="(struct mapi_nameid *mapi_nameid, uint16_t lid, const char *OLEGUID)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_lid_add </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t </td>
<td class="paramname"> <em>lid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OLEGUID</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Add a <a class="el" href="structmapi__nameid.html">mapi_nameid</a> entry given its lid and OLEGUID (MNID_ID)</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>lid</em> </td><td>the light ID of the name property (used by MNID_ID named props only) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OLEGUID</em> </td><td>the property set this entry belongs to</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
<li>MAPI_E_NOT_FOUND: the entry intended to be added was not found</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#a68f9e170c1dfd3ecbe4e6a58afa54998">mapi_nameid_new</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="structmapi__nameid.html#af801cad10b0bdef13e50aeeab2e8e08f">mapi_nameid::nameid</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
</div>
</div>
<a class="anchor" id="a52592e7a4b3bb08e1f6d9c08ebddede1"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_lid_lookup" ref="a52592e7a4b3bb08e1f6d9c08ebddede1" args="(uint16_t lid, const char *OLEGUID, uint16_t *propType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_lid_lookup </td>
<td>(</td>
<td class="paramtype">uint16_t </td>
<td class="paramname"> <em>lid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OLEGUID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t * </td>
<td class="paramname"> <em>propType</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Search for a given lid,OLEGUID couple and return the associated propType.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>lid</em> </td><td>the named property light ID </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OLEGUID</em> </td><td>the named property GUID for this entry </td></tr>
<tr><td valign="top"></td><td valign="top"><em>propType</em> </td><td>pointer on returned named property type</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI_E_NOT_FOUND.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameter was not set properly.</li>
<li>MAPI_E_NOT_FOUND: no named property found </li>
</ul>
</dd></dl>
<p>References <a class="el" href="mapicode_8h.html#a7a4b9d7d8598946434a984fdb461eddb">OPENCHANGE_RETVAL_ERR</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
</div>
</div>
<a class="anchor" id="af7418bf978061721530b5f8fb8940694"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_lookup_SPropTagArray" ref="af7418bf978061721530b5f8fb8940694" args="(struct mapi_nameid *nameid, struct SPropTagArray *SPropTagArray)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_lookup_SPropTagArray </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropTagArray * </td>
<td class="paramname"> <em>SPropTagArray</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Loop over SPropTagArray and look for canonical named property tags we can add to the nameid structure.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>nameid</em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>SPropTagArray</em> </td><td>the array of property tags where to look for canonical named property tags.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
<li>MAPI_E_NOT_FOUND: no named property found</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="mapi__nameid_8c.html#acdd818c4090d6ea172953f5a97a033f4">mapi_nameid_canonical_add()</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
<p>Referenced by <a class="el" href="proto_8h.html#a2302fd8484a99435dcf605f79cf9e8ba">GetProps()</a>.</p>
</div>
</div>
<a class="anchor" id="a9d9381cc7e02705c8e638ada27d6ad57"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_lookup_SPropValue" ref="a9d9381cc7e02705c8e638ada27d6ad57" args="(struct mapi_nameid *mapi_nameid, struct SPropValue *lpProps, unsigned long PropCount)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_lookup_SPropValue </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropValue * </td>
<td class="paramname"> <em>lpProps</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned long </td>
<td class="paramname"> <em>PropCount</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Loop over lpProps and look for canonical named property tags we can add to the nameid structure.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>lpProps</em> </td><td>pointer on a SPropValue structure with the property tags where to look for canonical named property tags </td></tr>
<tr><td valign="top"></td><td valign="top"><em>PropCount</em> </td><td>count of lpProps elemense</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
<li>MAPI_E_NOT_FOUND: no named property found</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="mapi__nameid_8c.html#acdd818c4090d6ea172953f5a97a033f4">mapi_nameid_canonical_add()</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
<p>Referenced by <a class="el" href="proto_8h.html#a0718735fdc7da84886484ba44305d4af">SetPropertiesNoReplicate()</a>, and <a class="el" href="proto_8h.html#a0ddd5dd9827db2d23d94440042abab37">SetProps()</a>.</p>
</div>
</div>
<a class="anchor" id="a8662ee1914917df779ebf854361fb0bf"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_map_SPropTagArray" ref="a8662ee1914917df779ebf854361fb0bf" args="(struct mapi_nameid *mapi_nameid, struct SPropTagArray *SPropTagArray, struct SPropTagArray *SPropTagArray2)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_map_SPropTagArray </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropTagArray * </td>
<td class="paramname"> <em>SPropTagArray</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropTagArray * </td>
<td class="paramname"> <em>SPropTagArray2</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Replace named property tags in SPropTagArray with the property ID Exchange expects and stored in SPropTagArray2.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>SPropTagArray</em> </td><td>the array of property tags with original property tags </td></tr>
<tr><td valign="top"></td><td valign="top"><em>SPropTagArray2</em> </td><td>the array of named property tags resolved with GetIDsFromNames</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, <a class="el" href="structmapi__nameid__tags.html#a0579b939d6b3afabf41b26858c18fe8b">mapi_nameid_tags::position</a>, <a class="el" href="structmapi__nameid__tags.html#ab373b0f8886637e4962b9f602cda5b23">mapi_nameid_tags::proptag</a>, and <a class="el" href="structmapi__nameid__tags.html#ae8e10e9bbbe79d847177ab8336e82980">mapi_nameid_tags::propType</a>.</p>
<p>Referenced by <a class="el" href="proto_8h.html#a2302fd8484a99435dcf605f79cf9e8ba">GetProps()</a>.</p>
</div>
</div>
<a class="anchor" id="a6d5e2f646b696da66afcdf6632c293bf"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_map_SPropValue" ref="a6d5e2f646b696da66afcdf6632c293bf" args="(struct mapi_nameid *mapi_nameid, struct SPropValue *lpProps, uint32_t PropCount, struct SPropTagArray *SPropTagArray)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_map_SPropValue </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropValue * </td>
<td class="paramname"> <em>lpProps</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t </td>
<td class="paramname"> <em>PropCount</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropTagArray * </td>
<td class="paramname"> <em>SPropTagArray</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Replace named property tags in the SPropValue array with the property ID Exchange expects and stored in SPropTagArray.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>lpProps</em> </td><td>pointer on a SPropValue structure with property tags and values </td></tr>
<tr><td valign="top"></td><td valign="top"><em>PropCount</em> </td><td>count of lpProps elements </td></tr>
<tr><td valign="top"></td><td valign="top"><em>SPropTagArray</em> </td><td>the array of named property tags resolved with GetIDsFromNames</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, <a class="el" href="structmapi__nameid__tags.html#a0579b939d6b3afabf41b26858c18fe8b">mapi_nameid_tags::position</a>, <a class="el" href="structmapi__nameid__tags.html#ab373b0f8886637e4962b9f602cda5b23">mapi_nameid_tags::proptag</a>, and <a class="el" href="structmapi__nameid__tags.html#ae8e10e9bbbe79d847177ab8336e82980">mapi_nameid_tags::propType</a>.</p>
<p>Referenced by <a class="el" href="proto_8h.html#a0718735fdc7da84886484ba44305d4af">SetPropertiesNoReplicate()</a>, and <a class="el" href="proto_8h.html#a0ddd5dd9827db2d23d94440042abab37">SetProps()</a>.</p>
</div>
</div>
<a class="anchor" id="a7705209e3f79f856778b900123159f80"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_new" ref="a7705209e3f79f856778b900123159f80" args="(TALLOC_CTX *mem_ctx)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a>* mapi_nameid_new </td>
<td>(</td>
<td class="paramtype">TALLOC_CTX * </td>
<td class="paramname"> <em>mem_ctx</em></td>
<td> ) </td>
<td><code> [read]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Create a new <a class="el" href="structmapi__nameid.html">mapi_nameid</a> structure</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mem_ctx</em> </td><td>memory context to use for allocation</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to an allocated <a class="el" href="structmapi__nameid.html">mapi_nameid</a> structure on success, otherwise NULL</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, and <a class="el" href="structmapi__nameid.html#af801cad10b0bdef13e50aeeab2e8e08f">mapi_nameid::nameid</a>.</p>
<p>Referenced by <a class="el" href="proto_8h.html#a2302fd8484a99435dcf605f79cf9e8ba">GetProps()</a>, <a class="el" href="proto_8h.html#a0718735fdc7da84886484ba44305d4af">SetPropertiesNoReplicate()</a>, and <a class="el" href="proto_8h.html#a0ddd5dd9827db2d23d94440042abab37">SetProps()</a>.</p>
</div>
</div>
<a class="anchor" id="aa96315dd49d7670a915e2089a71fa28e"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_OOM_add" ref="aa96315dd49d7670a915e2089a71fa28e" args="(struct mapi_nameid *mapi_nameid, const char *OOM, const char *OLEGUID)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_OOM_add </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OOM</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OLEGUID</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Add a <a class="el" href="structmapi__nameid.html">mapi_nameid</a> entry given its OOM and OLEGUID (MNID_ID|MNID_STRING)</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OOM</em> </td><td>the Outlook Object Model matching string </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OLEGUID</em> </td><td>the property set this entry belongs to</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
<li>MAPI_E_NOT_FOUND: the entry intended to be added was not found</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#a68f9e170c1dfd3ecbe4e6a58afa54998">mapi_nameid_new</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="structmapi__nameid.html#af801cad10b0bdef13e50aeeab2e8e08f">mapi_nameid::nameid</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
</div>
</div>
<a class="anchor" id="aa35bf696e4b45822cd834475f03def4c"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_OOM_lookup" ref="aa35bf696e4b45822cd834475f03def4c" args="(const char *OOM, const char *OLEGUID, uint16_t *propType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_OOM_lookup </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OOM</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OLEGUID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t * </td>
<td class="paramname"> <em>propType</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Search for a given OOM,OLEGUID couple and return the associated propType.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>OOM</em> </td><td>The Outlook Object Model </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OLEGUID</em> </td><td>the named property GUID for this entry </td></tr>
<tr><td valign="top"></td><td valign="top"><em>propType</em> </td><td>pointer on returned named property type</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI_E_NOT_FOUND.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameter was not set properly.</li>
<li>MAPI_E_NOT_FOUND: no named property found </li>
</ul>
</dd></dl>
<p>References <a class="el" href="mapicode_8h.html#a7a4b9d7d8598946434a984fdb461eddb">OPENCHANGE_RETVAL_ERR</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
</div>
</div>
<a class="anchor" id="a69dc7a802ee37eeb57b2bcd0af4f77ff"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_SPropTagArray" ref="a69dc7a802ee37eeb57b2bcd0af4f77ff" args="(struct mapi_nameid *mapi_nameid, struct SPropTagArray *SPropTagArray)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_SPropTagArray </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropTagArray * </td>
<td class="paramname"> <em>SPropTagArray</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>set SPropTagArray ulPropTag property types from <a class="el" href="structmapi__nameid.html">mapi_nameid</a> returned by <a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a></p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>SPropTagArray</em> </td><td>the array of property tags returned by previous call to <a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a></td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, and <a class="el" href="structmapi__nameid__tags.html#ae8e10e9bbbe79d847177ab8336e82980">mapi_nameid_tags::propType</a>.</p>
</div>
</div>
<a class="anchor" id="a5ad1d6a8274cef96436cfec5b5d5e102"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_string_add" ref="a5ad1d6a8274cef96436cfec5b5d5e102" args="(struct mapi_nameid *mapi_nameid, const char *Name, const char *OLEGUID)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_string_add </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>Name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OLEGUID</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Add a <a class="el" href="structmapi__nameid.html">mapi_nameid</a> entry given its Name and OLEGUID (MNID_STRING)</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>Name</em> </td><td>the property name (used by MNID_STRING named props only) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OLEGUID</em> </td><td>the property set this entry belongs to</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
<li>MAPI_E_NOT_FOUND: the entry intended to be added was not found</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#a68f9e170c1dfd3ecbe4e6a58afa54998">mapi_nameid_new</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="structmapi__nameid.html#af801cad10b0bdef13e50aeeab2e8e08f">mapi_nameid::nameid</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
</div>
</div>
<a class="anchor" id="a877dc914ab217c926f80095862e2e99f"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_string_lookup" ref="a877dc914ab217c926f80095862e2e99f" args="(const char *Name, const char *OLEGUID, uint16_t *propType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_string_lookup </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>Name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>OLEGUID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint16_t * </td>
<td class="paramname"> <em>propType</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Search for a given Name,OLEGUID couple and return the associated propType.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Name</em> </td><td>the named property name </td></tr>
<tr><td valign="top"></td><td valign="top"><em>OLEGUID</em> </td><td>the named property GUID for this entry </td></tr>
<tr><td valign="top"></td><td valign="top"><em>propType</em> </td><td>pointer on returned named property type</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI_E_NOT_FOUND.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameter was not set properly.</li>
<li>MAPI_E_NOT_FOUND: no named property found </li>
</ul>
</dd></dl>
<p>References <a class="el" href="mapicode_8h.html#a7a4b9d7d8598946434a984fdb461eddb">OPENCHANGE_RETVAL_ERR</a>, and <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>.</p>
</div>
</div>
<a class="anchor" id="ad4237bda2484c14ee13fa7f2f5681345"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_unmap_SPropTagArray" ref="ad4237bda2484c14ee13fa7f2f5681345" args="(struct mapi_nameid *mapi_nameid, struct SPropTagArray *SPropTagArray)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_unmap_SPropTagArray </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropTagArray * </td>
<td class="paramname"> <em>SPropTagArray</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Restore the original SPropTagArray array with the property tags saved in the <a class="el" href="structmapi__nameid.html">mapi_nameid</a> structure.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>SPropTagArray</em> </td><td>the array of property tags with original property tags</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, <a class="el" href="structmapi__nameid__tags.html#a0579b939d6b3afabf41b26858c18fe8b">mapi_nameid_tags::position</a>, and <a class="el" href="structmapi__nameid__tags.html#ab373b0f8886637e4962b9f602cda5b23">mapi_nameid_tags::proptag</a>.</p>
<p>Referenced by <a class="el" href="proto_8h.html#a2302fd8484a99435dcf605f79cf9e8ba">GetProps()</a>.</p>
</div>
</div>
<a class="anchor" id="a9429aa3e7cbb75a388fc5b1fc03cbec8"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_unmap_SPropValue" ref="a9429aa3e7cbb75a388fc5b1fc03cbec8" args="(struct mapi_nameid *mapi_nameid, struct SPropValue *lpProps, uint32_t PropCount)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ enum MAPISTATUS mapi_nameid_unmap_SPropValue </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmapi__nameid.html">mapi_nameid</a> * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">struct SPropValue * </td>
<td class="paramname"> <em>lpProps</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t </td>
<td class="paramname"> <em>PropCount</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Restore the original SPropValue array with the property tags saved in the <a class="el" href="structmapi__nameid.html">mapi_nameid</a> structure.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="structmapi__nameid.html">mapi_nameid</a></em> </td><td>the structure where results are stored </td></tr>
<tr><td valign="top"></td><td valign="top"><em>lpProps</em> </td><td>the array of SPropValue structures with original property tags </td></tr>
<tr><td valign="top"></td><td valign="top"><em>PropCount</em> </td><td>count of lpProps elements</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError()</a> to retrieve the last MAPI error code. Possible MAPI error codes are:<ul>
<li>MAPI_E_INVALID_PARAMETER: one of the parameters was not set properly</li>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="structmapi__nameid.html#a8982a0ada9645b0af61dd0a9aa50b8d0">mapi_nameid::count</a>, <a class="el" href="structmapi__nameid.html#a9794f3dd19dbccce903a8498bb4b34c0">mapi_nameid::entries</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, <a class="el" href="structmapi__nameid__tags.html#a0579b939d6b3afabf41b26858c18fe8b">mapi_nameid_tags::position</a>, and <a class="el" href="structmapi__nameid__tags.html#ab373b0f8886637e4962b9f602cda5b23">mapi_nameid_tags::proptag</a>.</p>
<p>Referenced by <a class="el" href="proto_8h.html#a0718735fdc7da84886484ba44305d4af">SetPropertiesNoReplicate()</a>, and <a class="el" href="proto_8h.html#a0ddd5dd9827db2d23d94440042abab37">SetProps()</a>.</p>
</div>
</div>
</div>
</div>
<br/>
<table style="clear:both; margin: 0.5em auto; width:80%; text-align: center; background-color:#f8f8f8; border:2px solid #e0e0e0; padding:5px;">
<tr>
<td>
<img alt="Creative Commons License" src="CC_SomeRightsReserved.png" width="90" height="30" border="0" /><br />
<img alt="Creative Commons Attribution icon" src="24px-Cc-by_white.svg.png" width="24" height="24" border="0" />
<img alt="Creative Commons Share Alike icon" src="24px-Cc-sa_white.svg.png" width="24" height="24" border="0" />
</td>
<td> <i><strong class="selflink">This content</strong> is licensed under the Creative Commons<br />
Attribution ShareAlike License v. 3.0:<br />
<a href="http://creativecommons.org/licenses/by-sa/3.0/" class="external free" title="http://creativecommons.org/licenses/by-sa/3.0/" rel="nofollow">http://creativecommons.org/licenses/by-sa/3.0/</a></i>
</td></tr></table>
<br/>
</div>
</div>
</body>
</html>
