<html>
<head>
<title>MAPIClientLibraries 0.8 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.5.9 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<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="tabs">
<ul>
<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="contents">
<h1>libmapi/mapi_nameid.c File Reference</h1>mapi_nameid convenience API
<a href="#_details">More...</a>
<p>
<code>#include <libmapi/libmapi.h></code><br>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#cdd818c4090d6ea172953f5a97a033f4">mapi_nameid_canonical_add</a> (struct mapi_nameid *mapi_nameid, uint32_t proptag)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#16b6f67c39ba6f4464a1f8c4636d95d2">mapi_nameid_custom_lid_add</a> (struct mapi_nameid *mapi_nameid, uint16_t lid, uint16_t propType, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#34710e905d2bcf098de2365415453c38">mapi_nameid_custom_string_add</a> (struct mapi_nameid *mapi_nameid, const char *Name, uint16_t propType, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#6c24860883850bc1cb7acc5350dc6b4b">mapi_nameid_GetIDsFromNames</a> (struct mapi_nameid *mapi_nameid, mapi_object_t *obj, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#3410b119334bc8fb8e8019f0127dd5fc">mapi_nameid_lid_add</a> (struct mapi_nameid *mapi_nameid, uint16_t lid, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#52592e7a4b3bb08e1f6d9c08ebddede1">mapi_nameid_lid_lookup</a> (uint16_t lid, const char *OLEGUID, uint16_t *propType)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#f7418bf978061721530b5f8fb8940694">mapi_nameid_lookup_SPropTagArray</a> (struct mapi_nameid *nameid, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#9d9381cc7e02705c8e638ada27d6ad57">mapi_nameid_lookup_SPropValue</a> (struct mapi_nameid *mapi_nameid, struct SPropValue *lpProps, unsigned long PropCount)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#8662ee1914917df779ebf854361fb0bf">mapi_nameid_map_SPropTagArray</a> (struct mapi_nameid *mapi_nameid, struct SPropTagArray *SPropTagArray, struct SPropTagArray *SPropTagArray2)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#6d5e2f646b696da66afcdf6632c293bf">mapi_nameid_map_SPropValue</a> (struct mapi_nameid *mapi_nameid, struct SPropValue *lpProps, uint32_t PropCount, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ struct mapi_nameid * </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#7705209e3f79f856778b900123159f80">mapi_nameid_new</a> (TALLOC_CTX *mem_ctx)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a96315dd49d7670a915e2089a71fa28e">mapi_nameid_OOM_add</a> (struct mapi_nameid *mapi_nameid, const char *OOM, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#a35bf696e4b45822cd834475f03def4c">mapi_nameid_OOM_lookup</a> (const char *OOM, const char *OLEGUID, uint16_t *propType)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#69dc7a802ee37eeb57b2bcd0af4f77ff">mapi_nameid_SPropTagArray</a> (struct mapi_nameid *mapi_nameid, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#5ad1d6a8274cef96436cfec5b5d5e102">mapi_nameid_string_add</a> (struct mapi_nameid *mapi_nameid, const char *Name, const char *OLEGUID)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#877dc914ab217c926f80095862e2e99f">mapi_nameid_string_lookup</a> (const char *Name, const char *OLEGUID, uint16_t *propType)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#d4237bda2484c14ee13fa7f2f5681345">mapi_nameid_unmap_SPropTagArray</a> (struct mapi_nameid *mapi_nameid, struct SPropTagArray *SPropTagArray)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">_PUBLIC_ enum MAPISTATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__nameid_8c.html#9429aa3e7cbb75a388fc5b1fc03cbec8">mapi_nameid_unmap_SPropValue</a> (struct mapi_nameid *mapi_nameid, struct SPropValue *lpProps, uint32_t PropCount)</td></tr>
</table>
<hr><h2>Detailed Description</h2>
mapi_nameid convenience API
<p>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="cdd818c4090d6ea172953f5a97a033f4"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_canonical_add" ref="cdd818c4090d6ea172953f5a97a033f4" 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 mapi_nameid * </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 mapi_nameid entry given its canonical property tag<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="mapi__nameid_8c.html#7705209e3f79f856778b900123159f80">mapi_nameid_new</a> </dd></dl>
<p>Referenced by <a class="el" href="mapi__nameid_8c_source.html#l00761">mapi_nameid_lookup_SPropTagArray()</a>, and <a class="el" href="mapi__nameid_8c_source.html#l00808">mapi_nameid_lookup_SPropValue()</a>.</p>
</div>
</div><p>
<a class="anchor" name="16b6f67c39ba6f4464a1f8c4636d95d2"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_custom_lid_add" ref="16b6f67c39ba6f4464a1f8c4636d95d2" 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 mapi_nameid * </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 compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="mapi__nameid_8c.html#7705209e3f79f856778b900123159f80">mapi_nameid_new</a>, <a class="el" href="mapi__nameid_8c.html#3410b119334bc8fb8e8019f0127dd5fc">mapi_nameid_lid_add</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="34710e905d2bcf098de2365415453c38"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_custom_string_add" ref="34710e905d2bcf098de2365415453c38" 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 mapi_nameid * </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 compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="mapi__nameid_8c.html#7705209e3f79f856778b900123159f80">mapi_nameid_new</a>, <a class="el" href="mapi__nameid_8c.html#5ad1d6a8274cef96436cfec5b5d5e102">mapi_nameid_string_add</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="6c24860883850bc1cb7acc5350dc6b4b"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_GetIDsFromNames" ref="6c24860883850bc1cb7acc5350dc6b4b" 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 mapi_nameid * </td>
<td class="paramname"> <em>mapi_nameid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">mapi_object_t * </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>
This convenient function calls <a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a> and returns property tags with their real property type.<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a>, <a class="el" href="mapi__nameid_8c.html#69dc7a802ee37eeb57b2bcd0af4f77ff">mapi_nameid_SPropTagArray</a> </dd></dl>
<p>References <a class="el" href="IMAPIProp_8c_source.html#l00922">GetIDsFromNames()</a>, and <a class="el" href="IUnknown_8c_source.html#l00166">GetLastError()</a>.</p>
</div>
</div><p>
<a class="anchor" name="3410b119334bc8fb8e8019f0127dd5fc"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_lid_add" ref="3410b119334bc8fb8e8019f0127dd5fc" 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 mapi_nameid * </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 mapi_nameid entry given its lid and OLEGUID (MNID_ID)<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="mapi__nameid_8c.html#7705209e3f79f856778b900123159f80">mapi_nameid_new</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="52592e7a4b3bb08e1f6d9c08ebddede1"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_lid_lookup" ref="52592e7a4b3bb08e1f6d9c08ebddede1" 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 compact><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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI_E_NOT_FOUND.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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>
</div>
</div><p>
<a class="anchor" name="f7418bf978061721530b5f8fb8940694"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_lookup_SPropTagArray" ref="f7418bf978061721530b5f8fb8940694" 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 mapi_nameid * </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 compact><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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="mapi__nameid_8c_source.html#l00380">mapi_nameid_canonical_add()</a>.</p>
<p>Referenced by <a class="el" href="IMAPIProp_8c_source.html#l00059">GetProps()</a>.</p>
</div>
</div><p>
<a class="anchor" name="9d9381cc7e02705c8e638ada27d6ad57"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_lookup_SPropValue" ref="9d9381cc7e02705c8e638ada27d6ad57" 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 mapi_nameid * </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 compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> </dd></dl>
<p>References <a class="el" href="mapi__nameid_8c_source.html#l00380">mapi_nameid_canonical_add()</a>.</p>
<p>Referenced by <a class="el" href="IMAPIProp_8c_source.html#l00627">SetPropertiesNoReplicate()</a>, and <a class="el" href="IMAPIProp_8c_source.html#l00181">SetProps()</a>.</p>
</div>
</div><p>
<a class="anchor" name="8662ee1914917df779ebf854361fb0bf"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_map_SPropTagArray" ref="8662ee1914917df779ebf854361fb0bf" 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 mapi_nameid * </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 compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_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 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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> </dd></dl>
<p>Referenced by <a class="el" href="IMAPIProp_8c_source.html#l00059">GetProps()</a>.</p>
</div>
</div><p>
<a class="anchor" name="6d5e2f646b696da66afcdf6632c293bf"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_map_SPropValue" ref="6d5e2f646b696da66afcdf6632c293bf" 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 mapi_nameid * </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 compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> </dd></dl>
<p>Referenced by <a class="el" href="IMAPIProp_8c_source.html#l00627">SetPropertiesNoReplicate()</a>, and <a class="el" href="IMAPIProp_8c_source.html#l00181">SetProps()</a>.</p>
</div>
</div><p>
<a class="anchor" name="7705209e3f79f856778b900123159f80"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_new" ref="7705209e3f79f856778b900123159f80" args="(TALLOC_CTX *mem_ctx)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_PUBLIC_ struct mapi_nameid* 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 mapi_nameid structure<p>
<dl compact><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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>a pointer to an allocated mapi_nameid structure on success, otherwise NULL</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> </dd></dl>
<p>Referenced by <a class="el" href="IMAPIProp_8c_source.html#l00059">GetProps()</a>, <a class="el" href="IMAPIProp_8c_source.html#l00627">SetPropertiesNoReplicate()</a>, and <a class="el" href="IMAPIProp_8c_source.html#l00181">SetProps()</a>.</p>
</div>
</div><p>
<a class="anchor" name="a96315dd49d7670a915e2089a71fa28e"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_OOM_add" ref="a96315dd49d7670a915e2089a71fa28e" 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 mapi_nameid * </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 mapi_nameid entry given its OOM and OLEGUID (MNID_ID|MNID_STRING)<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="mapi__nameid_8c.html#7705209e3f79f856778b900123159f80">mapi_nameid_new</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="a35bf696e4b45822cd834475f03def4c"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_OOM_lookup" ref="a35bf696e4b45822cd834475f03def4c" 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 compact><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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI_E_NOT_FOUND.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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>
</div>
</div><p>
<a class="anchor" name="69dc7a802ee37eeb57b2bcd0af4f77ff"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_SPropTagArray" ref="69dc7a802ee37eeb57b2bcd0af4f77ff" 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 mapi_nameid * </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 mapi_nameid returned by <a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a><p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_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 returned by previous call to <a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a></td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="5ad1d6a8274cef96436cfec5b5d5e102"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_string_add" ref="5ad1d6a8274cef96436cfec5b5d5e102" 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 mapi_nameid * </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 mapi_nameid entry given its Name and OLEGUID (MNID_STRING)<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="mapi__nameid_8c.html#7705209e3f79f856778b900123159f80">mapi_nameid_new</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="877dc914ab217c926f80095862e2e99f"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_string_lookup" ref="877dc914ab217c926f80095862e2e99f" 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 compact><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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI_E_NOT_FOUND.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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>
</div>
</div><p>
<a class="anchor" name="d4237bda2484c14ee13fa7f2f5681345"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_unmap_SPropTagArray" ref="d4237bda2484c14ee13fa7f2f5681345" 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 mapi_nameid * </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 mapi_nameid structure.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_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 with original property tags</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> </dd></dl>
<p>Referenced by <a class="el" href="IMAPIProp_8c_source.html#l00059">GetProps()</a>.</p>
</div>
</div><p>
<a class="anchor" name="9429aa3e7cbb75a388fc5b1fc03cbec8"></a><!-- doxytag: member="mapi_nameid.c::mapi_nameid_unmap_SPropValue" ref="9429aa3e7cbb75a388fc5b1fc03cbec8" 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 mapi_nameid * </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 mapi_nameid structure.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mapi_nameid</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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Developers may also call <a class="el" href="IUnknown_8c.html#8237c7fc76377cb07f3f55920d6f20de">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" compact><dt><b>See also:</b></dt><dd><a class="el" href="IMAPIProp_8c.html#c7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> </dd></dl>
<p>Referenced by <a class="el" href="IMAPIProp_8c_source.html#l00627">SetPropertiesNoReplicate()</a>, and <a class="el" href="IMAPIProp_8c_source.html#l00181">SetProps()</a>.</p>
</div>
</div><p>
</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>
