Sophie

Sophie

distrib > Fedora > 14 > x86_64 > by-pkgid > 1760bbde8794f5b323299b3a051b5bd6 > files > 191

openchange-devel-0.9-11.fc14.x86_64.rpm

<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&nbsp;Page</span></a></li>
      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;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&nbsp;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="#define-members">Defines</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>libmapi/mapi_object.c File Reference</h1>  </div>
</div>
<div class="contents">

<p>mapi_object_t support functions  
<a href="#_details">More...</a></p>
<code>#include &lt;<a class="el" href="libmapi_8h.html">libmapi/libmapi.h</a>&gt;</code><br/>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="define-members"></a>
Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a5fdc7facea201bfce4ad308105f88d0c">INVALID_HANDLE_VALUE</a>&nbsp;&nbsp;&nbsp;0xffffffff</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">keep intern to this file  <a href="#a5fdc7facea201bfce4ad308105f88d0c"></a><br/></td></tr>
<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&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a696fc653219d446271c85fffc100e157">mapi_object_bookmark_debug</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj_table)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum MAPISTATUS&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#aede7db5a93dc819adc88cb4392a3314b">mapi_object_bookmark_find</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj_table, uint32_t bkPosition, struct SBinary_short *bin)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a6ae3b6b354ffa1ec70b92e3e6dcfd86f">mapi_object_bookmark_get_count</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj_table, uint32_t *count)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a6f2f8a23b373d094c8e5606e1be50262">mapi_object_copy</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *dst, <a class="el" href="structmapi__object.html">mapi_object_t</a> *src)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a88326d52d8779ddfa64a3603fcf4828a">mapi_object_debug</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="mapi__object_8h.html#a1f94f77e690224b6673c37d92c65a0fd">mapi_handle_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ <a class="el" href="mapi__object_8h.html#ac1033858b28ee56b5f4d1578c297b87e">mapi_id_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#ad4477e1e7c6dd8314638a9886b570209">mapi_object_get_id</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj, uint8_t *logon_id)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ struct <a class="el" href="structmapi__session.html">mapi_session</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#af49c3130b8cb47f741ff652fc53c1364">mapi_object_init</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a3a4550bbdf5094863d579c3e74aa170f">mapi_object_is_invalid</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#ade2b4701fae8a110c476b894834831b9">mapi_object_release</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a6cad283dc5a1228734e816adb30aa53c">mapi_object_set_handle</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj, <a class="el" href="mapi__object_8h.html#a1f94f77e690224b6673c37d92c65a0fd">mapi_handle_t</a> handle)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a87947ae1569ed162473811bb257922cb">mapi_object_set_id</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj, <a class="el" href="mapi__object_8h.html#ac1033858b28ee56b5f4d1578c297b87e">mapi_id_t</a> id)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a845af67422945480121797b8a44ab14d">mapi_object_set_logon_id</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj, uint8_t logon_id)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a5ae14832b40db995554d07a2bbdb59fd">mapi_object_set_logon_store</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">_PUBLIC_ void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a373e9bd46155ea22e816fa66944f22a6">mapi_object_set_session</a> (<a class="el" href="structmapi__object.html">mapi_object_t</a> *obj, struct <a class="el" href="structmapi__session.html">mapi_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="mapi__object_8c.html#a678facb39f5979fec7ad08f2659d5181">mapi_object_table_init</a> (TALLOC_CTX *mem_ctx, <a class="el" href="structmapi__object.html">mapi_object_t</a> *obj_table)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>mapi_object_t support functions </p>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="a5fdc7facea201bfce4ad308105f88d0c"></a><!-- doxytag: member="mapi_object.c::INVALID_HANDLE_VALUE" ref="a5fdc7facea201bfce4ad308105f88d0c" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define INVALID_HANDLE_VALUE&nbsp;&nbsp;&nbsp;0xffffffff</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>keep intern to this file </p>

<p>Referenced by <a class="el" href="mapi__object_8c.html#a3a4550bbdf5094863d579c3e74aa170f">mapi_object_is_invalid()</a>, and <a class="el" href="proto_8h.html#a478e58fdcbb9d5c037cd18cddfc0b008">mapi_object_release()</a>.</p>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="a696fc653219d446271c85fffc100e157"></a><!-- doxytag: member="mapi_object.c::mapi_object_bookmark_debug" ref="a696fc653219d446271c85fffc100e157" args="(mapi_object_t *obj_table)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ enum MAPISTATUS mapi_object_bookmark_debug </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj_table</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Dump bookmarks associated to a MAPI object table</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj_table</em>&nbsp;</td><td>pointer on the MAPI object table</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error. </dd></dl>

<p>References <a class="el" href="structmapi__obj__bookmark.html#ad6b6f0ee39f7de1ddc6ae3060ce9f9af">mapi_obj_bookmark::bin</a>, <a class="el" href="structmapi__obj__table.html#a6a29be7f089d4fe4da5fdf30f216942e">mapi_obj_table::bookmark</a>, <a class="el" href="cdo__mapi_8c.html#aa3c2b68912988f290961037c76478495">global_mapi_ctx</a>, <a class="el" href="structmapi__obj__bookmark.html#aac70ffb6ecba2f353037ede7cbc64928">mapi_obj_bookmark::index</a>, <a class="el" href="structmapi__obj__bookmark.html#a46e99c47948648f7f45dd42c60e73588">mapi_obj_bookmark::next</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, and <a class="el" href="structmapi__object.html#af33195293d914107863508deadcfba80">mapi_object::private_data</a>.</p>

</div>
</div>
<a class="anchor" id="aede7db5a93dc819adc88cb4392a3314b"></a><!-- doxytag: member="mapi_object.c::mapi_object_bookmark_find" ref="aede7db5a93dc819adc88cb4392a3314b" args="(mapi_object_t *obj_table, uint32_t bkPosition, struct SBinary_short *bin)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum MAPISTATUS mapi_object_bookmark_find </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj_table</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint32_t&nbsp;</td>
          <td class="paramname"> <em>bkPosition</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">struct SBinary_short *&nbsp;</td>
          <td class="paramname"> <em>bin</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Fetch a bookmark within a MAPI object table</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj_table</em>&nbsp;</td><td>pointer on the MAPI object table </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bkPosition</em>&nbsp;</td><td>the bookmark position to find </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bin</em>&nbsp;</td><td>pointer on the Sbinary_short the function fills</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error. </dd></dl>

<p>References <a class="el" href="structmapi__obj__bookmark.html#ad6b6f0ee39f7de1ddc6ae3060ce9f9af">mapi_obj_bookmark::bin</a>, <a class="el" href="structmapi__obj__table.html#ae0c3a2497817f01d34a315ba9d37569d">mapi_obj_table::bk_last</a>, <a class="el" href="structmapi__obj__table.html#a6a29be7f089d4fe4da5fdf30f216942e">mapi_obj_table::bookmark</a>, <a class="el" href="cdo__mapi_8c.html#aa3c2b68912988f290961037c76478495">global_mapi_ctx</a>, <a class="el" href="structmapi__obj__bookmark.html#aac70ffb6ecba2f353037ede7cbc64928">mapi_obj_bookmark::index</a>, <a class="el" href="structmapi__obj__bookmark.html#a46e99c47948648f7f45dd42c60e73588">mapi_obj_bookmark::next</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, and <a class="el" href="structmapi__object.html#af33195293d914107863508deadcfba80">mapi_object::private_data</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#ae3c55e0b3aaaa9fd6056018d202f785d">FindRow()</a>, and <a class="el" href="proto_8h.html#abe8573f64f67df4a07e454a85a246d2a">SeekRowBookmark()</a>.</p>

</div>
</div>
<a class="anchor" id="a6ae3b6b354ffa1ec70b92e3e6dcfd86f"></a><!-- doxytag: member="mapi_object.c::mapi_object_bookmark_get_count" ref="a6ae3b6b354ffa1ec70b92e3e6dcfd86f" args="(mapi_object_t *obj_table, uint32_t *count)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ enum MAPISTATUS mapi_object_bookmark_get_count </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj_table</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint32_t *&nbsp;</td>
          <td class="paramname"> <em>count</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Retrieve the number of bookmarks stored in a MAPI object table</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj_table</em>&nbsp;</td><td>pointer to the MAPI object table </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>count</em>&nbsp;</td><td>pointer to the number of bookmarks to return</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error. </dd></dl>

<p>References <a class="el" href="structmapi__obj__table.html#ae0c3a2497817f01d34a315ba9d37569d">mapi_obj_table::bk_last</a>, <a class="el" href="cdo__mapi_8c.html#aa3c2b68912988f290961037c76478495">global_mapi_ctx</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, and <a class="el" href="structmapi__object.html#af33195293d914107863508deadcfba80">mapi_object::private_data</a>.</p>

</div>
</div>
<a class="anchor" id="a6f2f8a23b373d094c8e5606e1be50262"></a><!-- doxytag: member="mapi_object.c::mapi_object_copy" ref="a6f2f8a23b373d094c8e5606e1be50262" args="(mapi_object_t *dst, mapi_object_t *src)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ enum MAPISTATUS mapi_object_copy </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>dst</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>src</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Copy MAPI object</p>
<p>This function copies <a class="el" href="structmapi__object.html">mapi_object</a> data from source to destination.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>dst</em>&nbsp;</td><td>pointer on the destination MAPI object </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>src</em>&nbsp;</td><td>pointer on the source MAPI object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI_E_NOT_INITIALIZED </dd></dl>

<p>References <a class="el" href="structmapi__object.html#a707aa4577397f6e76fcea216d7e86b3d">mapi_object::handle</a>, <a class="el" href="structmapi__object.html#a289f272eefb0204c718ef2e9776db1a4">mapi_object::id</a>, <a class="el" href="structmapi__object.html#a7f279cd34d34053174efb869dad1b2be">mapi_object::logon_id</a>, <a class="el" href="mapicode_8h.html#a72f77c7e5d097e7b47c57c0405070d0c">OPENCHANGE_RETVAL_IF</a>, <a class="el" href="structmapi__object.html#af33195293d914107863508deadcfba80">mapi_object::private_data</a>, and <a class="el" href="structmapi__object.html#a103d82b68de929c4ad9beedf05f8ac85">mapi_object::session</a>.</p>

</div>
</div>
<a class="anchor" id="a88326d52d8779ddfa64a3603fcf4828a"></a><!-- doxytag: member="mapi_object.c::mapi_object_debug" ref="a88326d52d8779ddfa64a3603fcf4828a" args="(mapi_object_t *obj)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ void mapi_object_debug </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Dump a MAPI object (for debugging)</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer on the MAPI object to dump out </td></tr>
  </table>
  </dd>
</dl>

<p>References <a class="el" href="structmapi__object.html#a707aa4577397f6e76fcea216d7e86b3d">mapi_object::handle</a>, and <a class="el" href="structmapi__object.html#a289f272eefb0204c718ef2e9776db1a4">mapi_object::id</a>.</p>

</div>
</div>
<a class="anchor" id="aa94645f34e6c4bf1c0631dffb0742676"></a><!-- doxytag: member="mapi_object.c::mapi_object_get_handle" ref="aa94645f34e6c4bf1c0631dffb0742676" args="(mapi_object_t *obj)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="mapi__object_8h.html#a1f94f77e690224b6673c37d92c65a0fd">mapi_handle_t</a> mapi_object_get_handle </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Retrieve the handle associated to a MAPI object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer on the MAPI object to retrieve the handle from</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a valid MAPI object handle on success, otherwise -1. </dd></dl>

<p>References <a class="el" href="structmapi__object.html#a707aa4577397f6e76fcea216d7e86b3d">mapi_object::handle</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#a66c99e4c6eb8a7eae42a0abac01fa75b">Abort()</a>, <a class="el" href="proto_8h.html#ac6cfa306b6e2571569cb814110bd2b08">AbortSubmit()</a>, <a class="el" href="proto_8h.html#ad08d305d256d71bcad693f3fca0110b2">AddressTypes()</a>, <a class="el" href="proto_8h.html#aff3ad6ae2f56ce102be53059e51731fd">CloneStream()</a>, <a class="el" href="proto_8h.html#a0152e531768ef61f4d8a41f600c7fea1">CollapseRow()</a>, <a class="el" href="proto_8h.html#a745704b6a7fc08573e87571023cbfc44">CommitStream()</a>, <a class="el" href="proto_8h.html#a4716ce81dca05da5c568db239f95acfe">CopyFolder()</a>, <a class="el" href="proto_8h.html#a8ec4ba29f2a9b89edda4cda1c4c4856c">CopyProps()</a>, <a class="el" href="proto_8h.html#acb5175bbc1caa88d0d5b8ed053b02b34">CopyTo()</a>, <a class="el" href="proto_8h.html#a6fb9d9166a531189cf0d123b007609b5">CopyToStream()</a>, <a class="el" href="proto_8h.html#a9f7152a9db034fbf7cc7fa8e481bd226">CreateAttach()</a>, <a class="el" href="proto_8h.html#ae26c5f046e906601b2dd367f738e1658">CreateBookmark()</a>, <a class="el" href="proto_8h.html#aa0d3c0451ce5f8584cce650ca3223b04">CreateFolder()</a>, <a class="el" href="proto_8h.html#acd2d9aaa13e6138886bacdcea51695d3">CreateMessage()</a>, <a class="el" href="proto_8h.html#a82fa868e57de4841b97cc4b4e9f6fb8d">DeleteAttach()</a>, <a class="el" href="proto_8h.html#a89202179905d03cb95b31b430790b9a1">DeleteFolder()</a>, <a class="el" href="proto_8h.html#abd450cbfa8897602cbc1cc7e0fa56ce5">DeleteMessage()</a>, <a class="el" href="proto_8h.html#a65bbd0ee31de96fd372da08b3e2347e8">DeletePropertiesNoReplicate()</a>, <a class="el" href="proto_8h.html#a829a7a28788124c422e42d007b47e9e3">DeleteProps()</a>, <a class="el" href="proto_8h.html#a364dcbce3198d58aa0ab6a813411bcbf">EmptyFolder()</a>, <a class="el" href="proto_8h.html#ac449d69d77ab398535923a0859691ddf">ExpandRow()</a>, <a class="el" href="proto_8h.html#ae3c55e0b3aaaa9fd6056018d202f785d">FindRow()</a>, <a class="el" href="proto_8h.html#aa90bfd47eded92fdd5e73cb1a0023fd3">FreeBookmark()</a>, <a class="el" href="proto_8h.html#a3323b8ace0a76a8f9e53aa989bc886c1">GetAttachmentTable()</a>, <a class="el" href="proto_8h.html#a80bfa91f91a0627cb58fa6ce757d72c4">GetCollapseState()</a>, <a class="el" href="proto_8h.html#a8005a7edf302693a7277f1351382d0d5">GetContentsTable()</a>, <a class="el" href="proto_8h.html#ad5362cafba2a76a70b112c966abe5907">GetHierarchyTable()</a>, <a class="el" href="proto_8h.html#a938413416b0e656c72192174fc3b0eae">GetIdFromLongTermId()</a>, <a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames()</a>, <a class="el" href="proto_8h.html#a25e3ad84c849f51eed573febe892b9a6">GetLocalReplicaIds()</a>, <a class="el" href="proto_8h.html#a4cad41f7bd69a78a74285df9db265e73">GetLongTermIdFromId()</a>, <a class="el" href="proto_8h.html#a535ea169793b6eb4cd76a669672761d1">GetMessageStatus()</a>, <a class="el" href="proto_8h.html#ae3c6c832f8dddb0a4755dbc6c19c5233">GetNamesFromIDs()</a>, <a class="el" href="proto_8h.html#ae7c80d484ca025749951a291c61be3e2">GetOwningServers()</a>, <a class="el" href="proto_8h.html#aed96168262c4acfeab8d06ff35601aeb">GetPropList()</a>, <a class="el" href="proto_8h.html#a2302fd8484a99435dcf605f79cf9e8ba">GetProps()</a>, <a class="el" href="proto_8h.html#ae158380be31ef5121ebcccb99c5f980d">GetPropsAll()</a>, <a class="el" href="proto_8h.html#a1feaac1c7b54b25e599d8dbf68a72faf">GetReceiveFolder()</a>, <a class="el" href="proto_8h.html#ab60a3c481121ff3bce77f9266112a783">GetReceiveFolderTable()</a>, <a class="el" href="proto_8h.html#a7f0a6f074da61394f2cdeba437d8fc12">GetRulesTable()</a>, <a class="el" href="proto_8h.html#ac9358749be2737f24bcd909df8a75f56">GetSearchCriteria()</a>, <a class="el" href="proto_8h.html#a198f286f90fe17887d8af784292348d2">GetStatus()</a>, <a class="el" href="proto_8h.html#a15fb593a6c5c39272a48f478c3738d81">GetStoreState()</a>, <a class="el" href="proto_8h.html#a35a0dde04de76bbe473a19e92ec5f723">GetStreamSize()</a>, <a class="el" href="proto_8h.html#a0c8a9b8fc54139a1411aa9264acbe200">GetTable()</a>, <a class="el" href="proto_8h.html#ac896118a7a75e0d214a81cfea01089d9">GetTransportFolder()</a>, <a class="el" href="proto_8h.html#ad1b0270ffa8b70cdca16c0ece8661c96">GetValidAttach()</a>, <a class="el" href="proto_8h.html#a8af3857bd9d1eea00c7e5930599d2433">HardDeleteMessage()</a>, <a class="el" href="proto_8h.html#a89562462ecaf7522be6f0ed9d88125c5">HardDeleteMessagesAndSubfolders()</a>, <a class="el" href="proto_8h.html#af33e1c1b61a7b361621d68779342e811">LockRegionStream()</a>, <a class="el" href="mapi__object_8c.html#a3a4550bbdf5094863d579c3e74aa170f">mapi_object_is_invalid()</a>, <a class="el" href="proto_8h.html#a1166925df3bf36ba5bd3835d0917d1df">ModifyRecipients()</a>, <a class="el" href="proto_8h.html#afcd8006481ea667864a055148777a07e">ModifyTable()</a>, <a class="el" href="proto_8h.html#a583351a289546184e2560eac39f5a3d6">MoveCopyMessages()</a>, <a class="el" href="proto_8h.html#acf3f40942949ac192faaec2be8503992">MoveFolder()</a>, <a class="el" href="proto_8h.html#a8af2fe9cc98605fbda054d3091499ed2">OpenAttach()</a>, <a class="el" href="proto_8h.html#aaf3088b3837b1908e6bb6b14f906a4e0">OpenEmbeddedMessage()</a>, <a class="el" href="proto_8h.html#a5d20a82a73d463254ac5e688f0f0cb0f">OpenFolder()</a>, <a class="el" href="proto_8h.html#a26b91ebe67489ca9e12a2ad1ba71548c">OpenMessage()</a>, <a class="el" href="proto_8h.html#a8fda02d0b93fae98d923a82d86ca8c6c">OpenPublicFolderByName()</a>, <a class="el" href="proto_8h.html#a2be8f10c82ffcf8070e105f1a0d8c998">OpenStream()</a>, <a class="el" href="IMAPISupport_8c.html#a3c29b5dc6b137be136a5cf2695d55126">ProcessNotification()</a>, <a class="el" href="proto_8h.html#a3309fcb17b899dc8f86ecd7d3ed59eb5">PublicFolderIsGhosted()</a>, <a class="el" href="proto_8h.html#ae03f50328f9ef6369d5169893c8488df">QueryColumns()</a>, <a class="el" href="proto_8h.html#aa223b65b8bbcd97353c64aecdf10bd85">QueryNamedProperties()</a>, <a class="el" href="proto_8h.html#a65befabbd077db9273226a6d59615fdd">QueryPosition()</a>, <a class="el" href="proto_8h.html#a3124e8442e355ace743f5e554698eaa1">QueryRows()</a>, <a class="el" href="proto_8h.html#a6bc72b5c38aa15725d1454ad2c3635d0">ReadRecipients()</a>, <a class="el" href="proto_8h.html#ae0ef7c1c994a63e9cec5b1379122ed86">ReadStream()</a>, <a class="el" href="proto_8h.html#a96a886615abe0904621a25f73cb73839">Release()</a>, <a class="el" href="proto_8h.html#ab6424e4371c22d4cb24af0c5b954c46b">ReloadCachedInformation()</a>, <a class="el" href="proto_8h.html#ae625b8aeb2972e53df4608791fc77861">RemoveAllRecipients()</a>, <a class="el" href="proto_8h.html#a57497a9ec70a70382ed908bc883aaa41">Reset()</a>, <a class="el" href="proto_8h.html#a5e1d04f08b99a53ba88a2de930f65a16">Restrict()</a>, <a class="el" href="proto_8h.html#a4f63e29f1a02772254ba88ff7d916dee">SaveChangesAttachment()</a>, <a class="el" href="proto_8h.html#aae796bfcac7ea8bb4be2d6ef7eb93a76">SaveChangesMessage()</a>, <a class="el" href="proto_8h.html#ad0f277a2179be5b0377797f695157961">SeekRow()</a>, <a class="el" href="proto_8h.html#a450c999da38c526f1e7b7d26ec3c53fb">SeekRowApprox()</a>, <a class="el" href="proto_8h.html#abe8573f64f67df4a07e454a85a246d2a">SeekRowBookmark()</a>, <a class="el" href="proto_8h.html#a96670d887617ee8e4d5982b8ccc31bdf">SeekStream()</a>, <a class="el" href="proto_8h.html#a44dd9d7916dbbacec81d716978fbb040">SetCollapseState()</a>, <a class="el" href="proto_8h.html#a8695fc542a0924df6f34f1ececda5e58">SetColumns()</a>, <a class="el" href="proto_8h.html#af372f4a887ab6f689b63d43d09b04344">SetMessageReadFlag()</a>, <a class="el" href="proto_8h.html#a1e1e4a1093f379c20f444043650727f2">SetMessageStatus()</a>, <a class="el" href="proto_8h.html#a0718735fdc7da84886484ba44305d4af">SetPropertiesNoReplicate()</a>, <a class="el" href="proto_8h.html#a0ddd5dd9827db2d23d94440042abab37">SetProps()</a>, <a class="el" href="proto_8h.html#a8bb55368bb250bd04840c17b90be39a1">SetReadFlags()</a>, <a class="el" href="proto_8h.html#a35ac4767be928b741f30b55ef2c82651">SetReceiveFolder()</a>, <a class="el" href="proto_8h.html#a0ce94351576d968926636487793beaed">SetSearchCriteria()</a>, <a class="el" href="proto_8h.html#ad055d10119b399237b824d6fef5849d7">SetSpooler()</a>, <a class="el" href="proto_8h.html#a457cd46e47a75728f62d2066cfe83415">SetStreamSize()</a>, <a class="el" href="proto_8h.html#a348540581920b0e663f1a008f25bb643">SortTable()</a>, <a class="el" href="IXPLogon_8c.html#a8f5946010110ea49ade2d27446f37941">SpoolerLockMessage()</a>, <a class="el" href="proto_8h.html#a26d57152d73d8087c87e705f65691e32">SubmitMessage()</a>, <a class="el" href="proto_8h.html#a73891d48327dd1afee64dba5b7cfddc0">Subscribe()</a>, <a class="el" href="proto_8h.html#a8fa0a6ef77dcb6a1671e228e6f8f1fa4">TransportNewMail()</a>, <a class="el" href="proto_8h.html#a0f5eb34ea6ecea5bdc54d7b74a323f08">TransportSend()</a>, <a class="el" href="proto_8h.html#a01b7bea488771aa983179a42abd5e928">UnlockRegionStream()</a>, <a class="el" href="proto_8h.html#a0c3f3ba864f626e7a8fcd224cb2426fb">WriteAndCommitStream()</a>, and <a class="el" href="proto_8h.html#a2a14dfe1dcdacce01a7c7f67578632a0">WriteStream()</a>.</p>

</div>
</div>
<a class="anchor" id="ad4477e1e7c6dd8314638a9886b570209"></a><!-- doxytag: member="mapi_object.c::mapi_object_get_id" ref="ad4477e1e7c6dd8314638a9886b570209" args="(mapi_object_t *obj)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ <a class="el" href="mapi__object_8h.html#ac1033858b28ee56b5f4d1578c297b87e">mapi_id_t</a> mapi_object_get_id </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Retrieve an object ID for a given MAPI object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer on the MAPI object to get the ID for</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the object ID, or -1 if the object does not exist </dd></dl>

<p>References <a class="el" href="structmapi__object.html#a289f272eefb0204c718ef2e9776db1a4">mapi_object::id</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#ac6cfa306b6e2571569cb814110bd2b08">AbortSubmit()</a>, <a class="el" href="proto_8h.html#a4716ce81dca05da5c568db239f95acfe">CopyFolder()</a>, <a class="el" href="proto_8h.html#acd2d9aaa13e6138886bacdcea51695d3">CreateMessage()</a>, <a class="el" href="proto_8h.html#ae7c80d484ca025749951a291c61be3e2">GetOwningServers()</a>, <a class="el" href="proto_8h.html#a3dfe35b954981867acae68bba8793423">mapi_id_array_add_obj()</a>, <a class="el" href="proto_8h.html#ae8bb320a745b1ad4e4f01a8436a6c009">mapi_id_array_del_obj()</a>, <a class="el" href="proto_8h.html#acf3f40942949ac192faaec2be8503992">MoveFolder()</a>, <a class="el" href="proto_8h.html#a3309fcb17b899dc8f86ecd7d3ed59eb5">PublicFolderIsGhosted()</a>, <a class="el" href="proto_8h.html#a35ac4767be928b741f30b55ef2c82651">SetReceiveFolder()</a>, <a class="el" href="IXPLogon_8c.html#a8f5946010110ea49ade2d27446f37941">SpoolerLockMessage()</a>, <a class="el" href="proto_8h.html#a73891d48327dd1afee64dba5b7cfddc0">Subscribe()</a>, and <a class="el" href="proto_8h.html#a8fa0a6ef77dcb6a1671e228e6f8f1fa4">TransportNewMail()</a>.</p>

</div>
</div>
<a class="anchor" id="a96bfa7545b6e9ad350c42ba0abd07da8"></a><!-- doxytag: member="mapi_object.c::mapi_object_get_logon_id" ref="a96bfa7545b6e9ad350c42ba0abd07da8" args="(mapi_object_t *obj, uint8_t *logon_id)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ enum MAPISTATUS mapi_object_get_logon_id </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t *&nbsp;</td>
          <td class="paramname"> <em>logon_id</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Retrieve the logon id for a given MAPI object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer to the object to retrieve the logon id from </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>logon_id</em>&nbsp;</td><td>pointer to a variable to store the logon id</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error. </dd></dl>

<p>References <a class="el" href="structmapi__object.html#a7f279cd34d34053174efb869dad1b2be">mapi_object::logon_id</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#a66c99e4c6eb8a7eae42a0abac01fa75b">Abort()</a>, <a class="el" href="proto_8h.html#ac6cfa306b6e2571569cb814110bd2b08">AbortSubmit()</a>, <a class="el" href="proto_8h.html#ad08d305d256d71bcad693f3fca0110b2">AddressTypes()</a>, <a class="el" href="proto_8h.html#aff3ad6ae2f56ce102be53059e51731fd">CloneStream()</a>, <a class="el" href="proto_8h.html#a0152e531768ef61f4d8a41f600c7fea1">CollapseRow()</a>, <a class="el" href="proto_8h.html#a745704b6a7fc08573e87571023cbfc44">CommitStream()</a>, <a class="el" href="proto_8h.html#a4716ce81dca05da5c568db239f95acfe">CopyFolder()</a>, <a class="el" href="proto_8h.html#a8ec4ba29f2a9b89edda4cda1c4c4856c">CopyProps()</a>, <a class="el" href="proto_8h.html#acb5175bbc1caa88d0d5b8ed053b02b34">CopyTo()</a>, <a class="el" href="proto_8h.html#a6fb9d9166a531189cf0d123b007609b5">CopyToStream()</a>, <a class="el" href="proto_8h.html#a9f7152a9db034fbf7cc7fa8e481bd226">CreateAttach()</a>, <a class="el" href="proto_8h.html#ae26c5f046e906601b2dd367f738e1658">CreateBookmark()</a>, <a class="el" href="proto_8h.html#aa0d3c0451ce5f8584cce650ca3223b04">CreateFolder()</a>, <a class="el" href="proto_8h.html#acd2d9aaa13e6138886bacdcea51695d3">CreateMessage()</a>, <a class="el" href="proto_8h.html#a82fa868e57de4841b97cc4b4e9f6fb8d">DeleteAttach()</a>, <a class="el" href="proto_8h.html#a89202179905d03cb95b31b430790b9a1">DeleteFolder()</a>, <a class="el" href="proto_8h.html#abd450cbfa8897602cbc1cc7e0fa56ce5">DeleteMessage()</a>, <a class="el" href="proto_8h.html#a65bbd0ee31de96fd372da08b3e2347e8">DeletePropertiesNoReplicate()</a>, <a class="el" href="proto_8h.html#a829a7a28788124c422e42d007b47e9e3">DeleteProps()</a>, <a class="el" href="proto_8h.html#a364dcbce3198d58aa0ab6a813411bcbf">EmptyFolder()</a>, <a class="el" href="proto_8h.html#ac449d69d77ab398535923a0859691ddf">ExpandRow()</a>, <a class="el" href="proto_8h.html#ae3c55e0b3aaaa9fd6056018d202f785d">FindRow()</a>, <a class="el" href="proto_8h.html#aa90bfd47eded92fdd5e73cb1a0023fd3">FreeBookmark()</a>, <a class="el" href="proto_8h.html#a3323b8ace0a76a8f9e53aa989bc886c1">GetAttachmentTable()</a>, <a class="el" href="proto_8h.html#a80bfa91f91a0627cb58fa6ce757d72c4">GetCollapseState()</a>, <a class="el" href="proto_8h.html#a8005a7edf302693a7277f1351382d0d5">GetContentsTable()</a>, <a class="el" href="proto_8h.html#ad5362cafba2a76a70b112c966abe5907">GetHierarchyTable()</a>, <a class="el" href="proto_8h.html#a938413416b0e656c72192174fc3b0eae">GetIdFromLongTermId()</a>, <a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames()</a>, <a class="el" href="proto_8h.html#a25e3ad84c849f51eed573febe892b9a6">GetLocalReplicaIds()</a>, <a class="el" href="proto_8h.html#a4cad41f7bd69a78a74285df9db265e73">GetLongTermIdFromId()</a>, <a class="el" href="proto_8h.html#a535ea169793b6eb4cd76a669672761d1">GetMessageStatus()</a>, <a class="el" href="proto_8h.html#ae3c6c832f8dddb0a4755dbc6c19c5233">GetNamesFromIDs()</a>, <a class="el" href="proto_8h.html#ae7c80d484ca025749951a291c61be3e2">GetOwningServers()</a>, <a class="el" href="proto_8h.html#aed96168262c4acfeab8d06ff35601aeb">GetPropList()</a>, <a class="el" href="proto_8h.html#a2302fd8484a99435dcf605f79cf9e8ba">GetProps()</a>, <a class="el" href="proto_8h.html#ae158380be31ef5121ebcccb99c5f980d">GetPropsAll()</a>, <a class="el" href="proto_8h.html#a1feaac1c7b54b25e599d8dbf68a72faf">GetReceiveFolder()</a>, <a class="el" href="proto_8h.html#ab60a3c481121ff3bce77f9266112a783">GetReceiveFolderTable()</a>, <a class="el" href="proto_8h.html#a7f0a6f074da61394f2cdeba437d8fc12">GetRulesTable()</a>, <a class="el" href="proto_8h.html#ac9358749be2737f24bcd909df8a75f56">GetSearchCriteria()</a>, <a class="el" href="proto_8h.html#a198f286f90fe17887d8af784292348d2">GetStatus()</a>, <a class="el" href="proto_8h.html#a15fb593a6c5c39272a48f478c3738d81">GetStoreState()</a>, <a class="el" href="proto_8h.html#a35a0dde04de76bbe473a19e92ec5f723">GetStreamSize()</a>, <a class="el" href="proto_8h.html#a0c8a9b8fc54139a1411aa9264acbe200">GetTable()</a>, <a class="el" href="proto_8h.html#ac896118a7a75e0d214a81cfea01089d9">GetTransportFolder()</a>, <a class="el" href="proto_8h.html#ad1b0270ffa8b70cdca16c0ece8661c96">GetValidAttach()</a>, <a class="el" href="proto_8h.html#a8af3857bd9d1eea00c7e5930599d2433">HardDeleteMessage()</a>, <a class="el" href="proto_8h.html#a89562462ecaf7522be6f0ed9d88125c5">HardDeleteMessagesAndSubfolders()</a>, <a class="el" href="proto_8h.html#af33e1c1b61a7b361621d68779342e811">LockRegionStream()</a>, <a class="el" href="proto_8h.html#a1166925df3bf36ba5bd3835d0917d1df">ModifyRecipients()</a>, <a class="el" href="proto_8h.html#afcd8006481ea667864a055148777a07e">ModifyTable()</a>, <a class="el" href="proto_8h.html#a583351a289546184e2560eac39f5a3d6">MoveCopyMessages()</a>, <a class="el" href="proto_8h.html#acf3f40942949ac192faaec2be8503992">MoveFolder()</a>, <a class="el" href="proto_8h.html#a8af2fe9cc98605fbda054d3091499ed2">OpenAttach()</a>, <a class="el" href="proto_8h.html#aaf3088b3837b1908e6bb6b14f906a4e0">OpenEmbeddedMessage()</a>, <a class="el" href="proto_8h.html#a5d20a82a73d463254ac5e688f0f0cb0f">OpenFolder()</a>, <a class="el" href="proto_8h.html#a26b91ebe67489ca9e12a2ad1ba71548c">OpenMessage()</a>, <a class="el" href="proto_8h.html#a8fda02d0b93fae98d923a82d86ca8c6c">OpenPublicFolderByName()</a>, <a class="el" href="proto_8h.html#a2be8f10c82ffcf8070e105f1a0d8c998">OpenStream()</a>, <a class="el" href="proto_8h.html#a3309fcb17b899dc8f86ecd7d3ed59eb5">PublicFolderIsGhosted()</a>, <a class="el" href="proto_8h.html#ae03f50328f9ef6369d5169893c8488df">QueryColumns()</a>, <a class="el" href="proto_8h.html#aa223b65b8bbcd97353c64aecdf10bd85">QueryNamedProperties()</a>, <a class="el" href="proto_8h.html#a65befabbd077db9273226a6d59615fdd">QueryPosition()</a>, <a class="el" href="proto_8h.html#a3124e8442e355ace743f5e554698eaa1">QueryRows()</a>, <a class="el" href="proto_8h.html#a6bc72b5c38aa15725d1454ad2c3635d0">ReadRecipients()</a>, <a class="el" href="proto_8h.html#ae0ef7c1c994a63e9cec5b1379122ed86">ReadStream()</a>, <a class="el" href="proto_8h.html#a96a886615abe0904621a25f73cb73839">Release()</a>, <a class="el" href="proto_8h.html#ab6424e4371c22d4cb24af0c5b954c46b">ReloadCachedInformation()</a>, <a class="el" href="proto_8h.html#ae625b8aeb2972e53df4608791fc77861">RemoveAllRecipients()</a>, <a class="el" href="proto_8h.html#a57497a9ec70a70382ed908bc883aaa41">Reset()</a>, <a class="el" href="proto_8h.html#a5e1d04f08b99a53ba88a2de930f65a16">Restrict()</a>, <a class="el" href="proto_8h.html#a4f63e29f1a02772254ba88ff7d916dee">SaveChangesAttachment()</a>, <a class="el" href="proto_8h.html#aae796bfcac7ea8bb4be2d6ef7eb93a76">SaveChangesMessage()</a>, <a class="el" href="proto_8h.html#ad0f277a2179be5b0377797f695157961">SeekRow()</a>, <a class="el" href="proto_8h.html#a450c999da38c526f1e7b7d26ec3c53fb">SeekRowApprox()</a>, <a class="el" href="proto_8h.html#abe8573f64f67df4a07e454a85a246d2a">SeekRowBookmark()</a>, <a class="el" href="proto_8h.html#a96670d887617ee8e4d5982b8ccc31bdf">SeekStream()</a>, <a class="el" href="proto_8h.html#a44dd9d7916dbbacec81d716978fbb040">SetCollapseState()</a>, <a class="el" href="proto_8h.html#a8695fc542a0924df6f34f1ececda5e58">SetColumns()</a>, <a class="el" href="proto_8h.html#af372f4a887ab6f689b63d43d09b04344">SetMessageReadFlag()</a>, <a class="el" href="proto_8h.html#a1e1e4a1093f379c20f444043650727f2">SetMessageStatus()</a>, <a class="el" href="proto_8h.html#a0718735fdc7da84886484ba44305d4af">SetPropertiesNoReplicate()</a>, <a class="el" href="proto_8h.html#a0ddd5dd9827db2d23d94440042abab37">SetProps()</a>, <a class="el" href="proto_8h.html#a8bb55368bb250bd04840c17b90be39a1">SetReadFlags()</a>, <a class="el" href="proto_8h.html#a35ac4767be928b741f30b55ef2c82651">SetReceiveFolder()</a>, <a class="el" href="proto_8h.html#a0ce94351576d968926636487793beaed">SetSearchCriteria()</a>, <a class="el" href="proto_8h.html#ad055d10119b399237b824d6fef5849d7">SetSpooler()</a>, <a class="el" href="proto_8h.html#a457cd46e47a75728f62d2066cfe83415">SetStreamSize()</a>, <a class="el" href="proto_8h.html#a348540581920b0e663f1a008f25bb643">SortTable()</a>, <a class="el" href="IXPLogon_8c.html#a8f5946010110ea49ade2d27446f37941">SpoolerLockMessage()</a>, <a class="el" href="proto_8h.html#a26d57152d73d8087c87e705f65691e32">SubmitMessage()</a>, <a class="el" href="proto_8h.html#a73891d48327dd1afee64dba5b7cfddc0">Subscribe()</a>, <a class="el" href="proto_8h.html#a8fa0a6ef77dcb6a1671e228e6f8f1fa4">TransportNewMail()</a>, <a class="el" href="proto_8h.html#a0f5eb34ea6ecea5bdc54d7b74a323f08">TransportSend()</a>, <a class="el" href="proto_8h.html#a01b7bea488771aa983179a42abd5e928">UnlockRegionStream()</a>, <a class="el" href="proto_8h.html#a0c3f3ba864f626e7a8fcd224cb2426fb">WriteAndCommitStream()</a>, and <a class="el" href="proto_8h.html#a2a14dfe1dcdacce01a7c7f67578632a0">WriteStream()</a>.</p>

</div>
</div>
<a class="anchor" id="ae5ef3137838fbc0c3eaedd7da99f8adc"></a><!-- doxytag: member="mapi_object.c::mapi_object_get_session" ref="ae5ef3137838fbc0c3eaedd7da99f8adc" args="(mapi_object_t *obj)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ struct <a class="el" href="structmapi__session.html">mapi_session</a>* mapi_object_get_session </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td><code> [read]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Retrieve the session associated to the MAPI object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>the object to get the session for</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pointer on a MAPI session on success, otherwise NULL </dd></dl>

<p>References <a class="el" href="structmapi__object.html#a103d82b68de929c4ad9beedf05f8ac85">mapi_object::session</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#a66c99e4c6eb8a7eae42a0abac01fa75b">Abort()</a>, <a class="el" href="proto_8h.html#ac6cfa306b6e2571569cb814110bd2b08">AbortSubmit()</a>, <a class="el" href="proto_8h.html#ad08d305d256d71bcad693f3fca0110b2">AddressTypes()</a>, <a class="el" href="simple__mapi_8c.html#a2445fb102be62563bdd8d24025f3be2b">AddUserPermission()</a>, <a class="el" href="proto_8h.html#aff3ad6ae2f56ce102be53059e51731fd">CloneStream()</a>, <a class="el" href="proto_8h.html#a0152e531768ef61f4d8a41f600c7fea1">CollapseRow()</a>, <a class="el" href="proto_8h.html#a745704b6a7fc08573e87571023cbfc44">CommitStream()</a>, <a class="el" href="proto_8h.html#a4716ce81dca05da5c568db239f95acfe">CopyFolder()</a>, <a class="el" href="proto_8h.html#a8ec4ba29f2a9b89edda4cda1c4c4856c">CopyProps()</a>, <a class="el" href="proto_8h.html#acb5175bbc1caa88d0d5b8ed053b02b34">CopyTo()</a>, <a class="el" href="proto_8h.html#a6fb9d9166a531189cf0d123b007609b5">CopyToStream()</a>, <a class="el" href="proto_8h.html#a9f7152a9db034fbf7cc7fa8e481bd226">CreateAttach()</a>, <a class="el" href="proto_8h.html#ae26c5f046e906601b2dd367f738e1658">CreateBookmark()</a>, <a class="el" href="proto_8h.html#aa0d3c0451ce5f8584cce650ca3223b04">CreateFolder()</a>, <a class="el" href="proto_8h.html#acd2d9aaa13e6138886bacdcea51695d3">CreateMessage()</a>, <a class="el" href="proto_8h.html#a82fa868e57de4841b97cc4b4e9f6fb8d">DeleteAttach()</a>, <a class="el" href="proto_8h.html#a89202179905d03cb95b31b430790b9a1">DeleteFolder()</a>, <a class="el" href="proto_8h.html#abd450cbfa8897602cbc1cc7e0fa56ce5">DeleteMessage()</a>, <a class="el" href="proto_8h.html#a65bbd0ee31de96fd372da08b3e2347e8">DeletePropertiesNoReplicate()</a>, <a class="el" href="proto_8h.html#a829a7a28788124c422e42d007b47e9e3">DeleteProps()</a>, <a class="el" href="proto_8h.html#a364dcbce3198d58aa0ab6a813411bcbf">EmptyFolder()</a>, <a class="el" href="proto_8h.html#ac449d69d77ab398535923a0859691ddf">ExpandRow()</a>, <a class="el" href="proto_8h.html#ae3c55e0b3aaaa9fd6056018d202f785d">FindRow()</a>, <a class="el" href="proto_8h.html#aa90bfd47eded92fdd5e73cb1a0023fd3">FreeBookmark()</a>, <a class="el" href="proto_8h.html#a3323b8ace0a76a8f9e53aa989bc886c1">GetAttachmentTable()</a>, <a class="el" href="proto_8h.html#a80bfa91f91a0627cb58fa6ce757d72c4">GetCollapseState()</a>, <a class="el" href="proto_8h.html#a8005a7edf302693a7277f1351382d0d5">GetContentsTable()</a>, <a class="el" href="proto_8h.html#ad5362cafba2a76a70b112c966abe5907">GetHierarchyTable()</a>, <a class="el" href="proto_8h.html#a938413416b0e656c72192174fc3b0eae">GetIdFromLongTermId()</a>, <a class="el" href="proto_8h.html#af2084aa1318156973399cd8c7971912e">GetIDsFromNames()</a>, <a class="el" href="proto_8h.html#a25e3ad84c849f51eed573febe892b9a6">GetLocalReplicaIds()</a>, <a class="el" href="proto_8h.html#a4cad41f7bd69a78a74285df9db265e73">GetLongTermIdFromId()</a>, <a class="el" href="proto_8h.html#a535ea169793b6eb4cd76a669672761d1">GetMessageStatus()</a>, <a class="el" href="proto_8h.html#ae3c6c832f8dddb0a4755dbc6c19c5233">GetNamesFromIDs()</a>, <a class="el" href="proto_8h.html#ae7c80d484ca025749951a291c61be3e2">GetOwningServers()</a>, <a class="el" href="proto_8h.html#aed96168262c4acfeab8d06ff35601aeb">GetPropList()</a>, <a class="el" href="proto_8h.html#a2302fd8484a99435dcf605f79cf9e8ba">GetProps()</a>, <a class="el" href="proto_8h.html#ae158380be31ef5121ebcccb99c5f980d">GetPropsAll()</a>, <a class="el" href="proto_8h.html#a1feaac1c7b54b25e599d8dbf68a72faf">GetReceiveFolder()</a>, <a class="el" href="proto_8h.html#ab60a3c481121ff3bce77f9266112a783">GetReceiveFolderTable()</a>, <a class="el" href="proto_8h.html#a7f0a6f074da61394f2cdeba437d8fc12">GetRulesTable()</a>, <a class="el" href="proto_8h.html#ac9358749be2737f24bcd909df8a75f56">GetSearchCriteria()</a>, <a class="el" href="proto_8h.html#a198f286f90fe17887d8af784292348d2">GetStatus()</a>, <a class="el" href="proto_8h.html#a15fb593a6c5c39272a48f478c3738d81">GetStoreState()</a>, <a class="el" href="proto_8h.html#a35a0dde04de76bbe473a19e92ec5f723">GetStreamSize()</a>, <a class="el" href="proto_8h.html#a0c8a9b8fc54139a1411aa9264acbe200">GetTable()</a>, <a class="el" href="proto_8h.html#ac896118a7a75e0d214a81cfea01089d9">GetTransportFolder()</a>, <a class="el" href="proto_8h.html#a51ddeca55f13055917a8b43d28a5f11f">GetUserFreeBusyData()</a>, <a class="el" href="proto_8h.html#ad1b0270ffa8b70cdca16c0ece8661c96">GetValidAttach()</a>, <a class="el" href="proto_8h.html#a8af3857bd9d1eea00c7e5930599d2433">HardDeleteMessage()</a>, <a class="el" href="proto_8h.html#a89562462ecaf7522be6f0ed9d88125c5">HardDeleteMessagesAndSubfolders()</a>, <a class="el" href="proto_8h.html#ab76911cad62468f2d40c277e63e4b548">IsFreeBusyConflict()</a>, <a class="el" href="proto_8h.html#af33e1c1b61a7b361621d68779342e811">LockRegionStream()</a>, <a class="el" href="proto_8h.html#a6a291e98161f80abee74f43f13c26b72">Logoff()</a>, <a class="el" href="proto_8h.html#a1166925df3bf36ba5bd3835d0917d1df">ModifyRecipients()</a>, <a class="el" href="proto_8h.html#afcd8006481ea667864a055148777a07e">ModifyTable()</a>, <a class="el" href="simple__mapi_8c.html#a9cb54788ad5b18ab5e714405a043b049">ModifyUserPermission()</a>, <a class="el" href="proto_8h.html#a583351a289546184e2560eac39f5a3d6">MoveCopyMessages()</a>, <a class="el" href="proto_8h.html#acf3f40942949ac192faaec2be8503992">MoveFolder()</a>, <a class="el" href="proto_8h.html#a8af2fe9cc98605fbda054d3091499ed2">OpenAttach()</a>, <a class="el" href="proto_8h.html#aaf3088b3837b1908e6bb6b14f906a4e0">OpenEmbeddedMessage()</a>, <a class="el" href="proto_8h.html#a5d20a82a73d463254ac5e688f0f0cb0f">OpenFolder()</a>, <a class="el" href="proto_8h.html#a26b91ebe67489ca9e12a2ad1ba71548c">OpenMessage()</a>, <a class="el" href="proto_8h.html#a8fda02d0b93fae98d923a82d86ca8c6c">OpenPublicFolderByName()</a>, <a class="el" href="proto_8h.html#a2be8f10c82ffcf8070e105f1a0d8c998">OpenStream()</a>, <a class="el" href="proto_8h.html#a3309fcb17b899dc8f86ecd7d3ed59eb5">PublicFolderIsGhosted()</a>, <a class="el" href="proto_8h.html#ae03f50328f9ef6369d5169893c8488df">QueryColumns()</a>, <a class="el" href="proto_8h.html#aa223b65b8bbcd97353c64aecdf10bd85">QueryNamedProperties()</a>, <a class="el" href="proto_8h.html#a65befabbd077db9273226a6d59615fdd">QueryPosition()</a>, <a class="el" href="proto_8h.html#a3124e8442e355ace743f5e554698eaa1">QueryRows()</a>, <a class="el" href="proto_8h.html#a6bc72b5c38aa15725d1454ad2c3635d0">ReadRecipients()</a>, <a class="el" href="proto_8h.html#ae0ef7c1c994a63e9cec5b1379122ed86">ReadStream()</a>, <a class="el" href="proto_8h.html#a96a886615abe0904621a25f73cb73839">Release()</a>, <a class="el" href="proto_8h.html#ab6424e4371c22d4cb24af0c5b954c46b">ReloadCachedInformation()</a>, <a class="el" href="proto_8h.html#ae625b8aeb2972e53df4608791fc77861">RemoveAllRecipients()</a>, <a class="el" href="simple__mapi_8c.html#a6b974921b0a3421b48933e564230d664">RemoveUserPermission()</a>, <a class="el" href="proto_8h.html#a57497a9ec70a70382ed908bc883aaa41">Reset()</a>, <a class="el" href="proto_8h.html#a5e1d04f08b99a53ba88a2de930f65a16">Restrict()</a>, <a class="el" href="proto_8h.html#a4f63e29f1a02772254ba88ff7d916dee">SaveChangesAttachment()</a>, <a class="el" href="proto_8h.html#aae796bfcac7ea8bb4be2d6ef7eb93a76">SaveChangesMessage()</a>, <a class="el" href="proto_8h.html#ad0f277a2179be5b0377797f695157961">SeekRow()</a>, <a class="el" href="proto_8h.html#a450c999da38c526f1e7b7d26ec3c53fb">SeekRowApprox()</a>, <a class="el" href="proto_8h.html#abe8573f64f67df4a07e454a85a246d2a">SeekRowBookmark()</a>, <a class="el" href="proto_8h.html#a96670d887617ee8e4d5982b8ccc31bdf">SeekStream()</a>, <a class="el" href="proto_8h.html#a44dd9d7916dbbacec81d716978fbb040">SetCollapseState()</a>, <a class="el" href="proto_8h.html#a8695fc542a0924df6f34f1ececda5e58">SetColumns()</a>, <a class="el" href="proto_8h.html#af372f4a887ab6f689b63d43d09b04344">SetMessageReadFlag()</a>, <a class="el" href="proto_8h.html#a1e1e4a1093f379c20f444043650727f2">SetMessageStatus()</a>, <a class="el" href="proto_8h.html#a0718735fdc7da84886484ba44305d4af">SetPropertiesNoReplicate()</a>, <a class="el" href="proto_8h.html#a0ddd5dd9827db2d23d94440042abab37">SetProps()</a>, <a class="el" href="proto_8h.html#a8bb55368bb250bd04840c17b90be39a1">SetReadFlags()</a>, <a class="el" href="proto_8h.html#a35ac4767be928b741f30b55ef2c82651">SetReceiveFolder()</a>, <a class="el" href="proto_8h.html#a0ce94351576d968926636487793beaed">SetSearchCriteria()</a>, <a class="el" href="proto_8h.html#ad055d10119b399237b824d6fef5849d7">SetSpooler()</a>, <a class="el" href="proto_8h.html#a457cd46e47a75728f62d2066cfe83415">SetStreamSize()</a>, <a class="el" href="proto_8h.html#a348540581920b0e663f1a008f25bb643">SortTable()</a>, <a class="el" href="IXPLogon_8c.html#a8f5946010110ea49ade2d27446f37941">SpoolerLockMessage()</a>, <a class="el" href="proto_8h.html#a26d57152d73d8087c87e705f65691e32">SubmitMessage()</a>, <a class="el" href="proto_8h.html#a73891d48327dd1afee64dba5b7cfddc0">Subscribe()</a>, <a class="el" href="proto_8h.html#a8fa0a6ef77dcb6a1671e228e6f8f1fa4">TransportNewMail()</a>, <a class="el" href="proto_8h.html#a0f5eb34ea6ecea5bdc54d7b74a323f08">TransportSend()</a>, <a class="el" href="proto_8h.html#a01b7bea488771aa983179a42abd5e928">UnlockRegionStream()</a>, <a class="el" href="proto_8h.html#a0c3f3ba864f626e7a8fcd224cb2426fb">WriteAndCommitStream()</a>, and <a class="el" href="proto_8h.html#a2a14dfe1dcdacce01a7c7f67578632a0">WriteStream()</a>.</p>

</div>
</div>
<a class="anchor" id="af49c3130b8cb47f741ff652fc53c1364"></a><!-- doxytag: member="mapi_object.c::mapi_object_init" ref="af49c3130b8cb47f741ff652fc53c1364" args="(mapi_object_t *obj)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ enum MAPISTATUS mapi_object_init </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Initialize MAPI object</p>
<p>This function is required to be called before any manipulation of this MAPI object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>the object to initialize</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>
</ul>
</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="proto_8h.html#a478e58fdcbb9d5c037cd18cddfc0b008">mapi_object_release</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="fetchappointment_8c-example.html#a6">fetchappointment.c</a>, and <a class="el" href="fetchmail_8c-example.html#a6">fetchmail.c</a>.</dd>
</dl>
<p>References <a class="el" href="cdo__mapi_8c.html#aa3c2b68912988f290961037c76478495">global_mapi_ctx</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#aa0d3c0451ce5f8584cce650ca3223b04">CreateFolder()</a>, <a class="el" href="proto_8h.html#a51ddeca55f13055917a8b43d28a5f11f">GetUserFreeBusyData()</a>, <a class="el" href="simple__mapi_8c.html#a9cb54788ad5b18ab5e714405a043b049">ModifyUserPermission()</a>, <a class="el" href="simple__mapi_8c.html#a6b974921b0a3421b48933e564230d664">RemoveUserPermission()</a>, and <a class="el" href="proto_8h.html#a73891d48327dd1afee64dba5b7cfddc0">Subscribe()</a>.</p>

</div>
</div>
<a class="anchor" id="a3a4550bbdf5094863d579c3e74aa170f"></a><!-- doxytag: member="mapi_object.c::mapi_object_is_invalid" ref="a3a4550bbdf5094863d579c3e74aa170f" args="(mapi_object_t *obj)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int mapi_object_is_invalid </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if the supplied object has a valid handle</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer on the MAPI object to test</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>0 on success, otherwise 1 </dd></dl>

<p>References <a class="el" href="mapi__object_8c.html#a5fdc7facea201bfce4ad308105f88d0c">INVALID_HANDLE_VALUE</a>, and <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>.</p>

</div>
</div>
<a class="anchor" id="ade2b4701fae8a110c476b894834831b9"></a><!-- doxytag: member="mapi_object.c::mapi_object_release" ref="ade2b4701fae8a110c476b894834831b9" args="(mapi_object_t *obj)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ void mapi_object_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Release MAPI object</p>
<p>This function is required to be called when this MAPI object is no longer required.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer on the MAPI object to release</td></tr>
  </table>
  </dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd>mapi_object_initialize, <a class="el" href="proto_8h.html#a96a886615abe0904621a25f73cb73839">Release</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="fetchappointment_8c-example.html#a23">fetchappointment.c</a>, and <a class="el" href="fetchmail_8c-example.html#a23">fetchmail.c</a>.</dd>
</dl>
<p>References <a class="el" href="structmapi__object.html#a707aa4577397f6e76fcea216d7e86b3d">mapi_object::handle</a>, <a class="el" href="mapi__object_8c.html#a5fdc7facea201bfce4ad308105f88d0c">INVALID_HANDLE_VALUE</a>, <a class="el" href="structmapi__object.html#a7f279cd34d34053174efb869dad1b2be">mapi_object::logon_id</a>, <a class="el" href="structmapi__session.html#a7a63adcc415b2220f2efb6cd175f2a67">mapi_session::logon_ids</a>, <a class="el" href="structmapi__object.html#af33195293d914107863508deadcfba80">mapi_object::private_data</a>, <a class="el" href="IUnknown_8c.html#ab3f224d83f10cbbcbeeeff3f4f73f230">Release()</a>, <a class="el" href="structmapi__object.html#a103d82b68de929c4ad9beedf05f8ac85">mapi_object::session</a>, and <a class="el" href="structmapi__object.html#ae7203e2fad471960c2dd25960cf585e8">mapi_object::store</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#a51ddeca55f13055917a8b43d28a5f11f">GetUserFreeBusyData()</a>, <a class="el" href="proto_8h.html#a6a291e98161f80abee74f43f13c26b72">Logoff()</a>, <a class="el" href="simple__mapi_8c.html#a9cb54788ad5b18ab5e714405a043b049">ModifyUserPermission()</a>, and <a class="el" href="simple__mapi_8c.html#a6b974921b0a3421b48933e564230d664">RemoveUserPermission()</a>.</p>

</div>
</div>
<a class="anchor" id="a6cad283dc5a1228734e816adb30aa53c"></a><!-- doxytag: member="mapi_object.c::mapi_object_set_handle" ref="a6cad283dc5a1228734e816adb30aa53c" args="(mapi_object_t *obj, mapi_handle_t handle)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void mapi_object_set_handle </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="mapi__object_8h.html#a1f94f77e690224b6673c37d92c65a0fd">mapi_handle_t</a>&nbsp;</td>
          <td class="paramname"> <em>handle</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Associate a handle to a MAPI object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer on the MAPI object on which handle has to be set </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>the MAPI handle value </td></tr>
  </table>
  </dd>
</dl>

<p>References <a class="el" href="structmapi__object.html#a707aa4577397f6e76fcea216d7e86b3d">mapi_object::handle</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#aff3ad6ae2f56ce102be53059e51731fd">CloneStream()</a>, <a class="el" href="proto_8h.html#a9f7152a9db034fbf7cc7fa8e481bd226">CreateAttach()</a>, <a class="el" href="proto_8h.html#aa0d3c0451ce5f8584cce650ca3223b04">CreateFolder()</a>, <a class="el" href="proto_8h.html#acd2d9aaa13e6138886bacdcea51695d3">CreateMessage()</a>, <a class="el" href="proto_8h.html#a3323b8ace0a76a8f9e53aa989bc886c1">GetAttachmentTable()</a>, <a class="el" href="proto_8h.html#a8005a7edf302693a7277f1351382d0d5">GetContentsTable()</a>, <a class="el" href="proto_8h.html#ad5362cafba2a76a70b112c966abe5907">GetHierarchyTable()</a>, <a class="el" href="proto_8h.html#a7f0a6f074da61394f2cdeba437d8fc12">GetRulesTable()</a>, <a class="el" href="proto_8h.html#a0c8a9b8fc54139a1411aa9264acbe200">GetTable()</a>, <a class="el" href="proto_8h.html#a8af2fe9cc98605fbda054d3091499ed2">OpenAttach()</a>, <a class="el" href="proto_8h.html#aaf3088b3837b1908e6bb6b14f906a4e0">OpenEmbeddedMessage()</a>, <a class="el" href="proto_8h.html#a5d20a82a73d463254ac5e688f0f0cb0f">OpenFolder()</a>, <a class="el" href="proto_8h.html#a26b91ebe67489ca9e12a2ad1ba71548c">OpenMessage()</a>, <a class="el" href="proto_8h.html#ac27ee071a1b0d8344bb0320a4a647f54">OpenPublicFolder()</a>, <a class="el" href="proto_8h.html#a8fda02d0b93fae98d923a82d86ca8c6c">OpenPublicFolderByName()</a>, <a class="el" href="proto_8h.html#a2be8f10c82ffcf8070e105f1a0d8c998">OpenStream()</a>, <a class="el" href="proto_8h.html#a7a2978c322cbed08f16de37682cdebde">OpenUserMailbox()</a>, and <a class="el" href="proto_8h.html#a73891d48327dd1afee64dba5b7cfddc0">Subscribe()</a>.</p>

</div>
</div>
<a class="anchor" id="a87947ae1569ed162473811bb257922cb"></a><!-- doxytag: member="mapi_object.c::mapi_object_set_id" ref="a87947ae1569ed162473811bb257922cb" args="(mapi_object_t *obj, mapi_id_t id)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void mapi_object_set_id </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="mapi__object_8h.html#ac1033858b28ee56b5f4d1578c297b87e">mapi_id_t</a>&nbsp;</td>
          <td class="paramname"> <em>id</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set the id for a given MAPI object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer on the MAPI object to set the session for </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>id</em>&nbsp;</td><td>Identifier to set to the object obj </td></tr>
  </table>
  </dd>
</dl>

<p>References <a class="el" href="structmapi__object.html#a289f272eefb0204c718ef2e9776db1a4">mapi_object::id</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#aa0d3c0451ce5f8584cce650ca3223b04">CreateFolder()</a>, <a class="el" href="proto_8h.html#a5d20a82a73d463254ac5e688f0f0cb0f">OpenFolder()</a>, and <a class="el" href="proto_8h.html#aae796bfcac7ea8bb4be2d6ef7eb93a76">SaveChangesMessage()</a>.</p>

</div>
</div>
<a class="anchor" id="a845af67422945480121797b8a44ab14d"></a><!-- doxytag: member="mapi_object.c::mapi_object_set_logon_id" ref="a845af67422945480121797b8a44ab14d" args="(mapi_object_t *obj, uint8_t logon_id)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ void mapi_object_set_logon_id </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t&nbsp;</td>
          <td class="paramname"> <em>logon_id</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set the logon id for a given MAPI object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer to the object to set the logon id for </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>logon_id</em>&nbsp;</td><td>the logon identifier to associate to the MAPI object </td></tr>
  </table>
  </dd>
</dl>

<p>References <a class="el" href="structmapi__object.html#a7f279cd34d34053174efb869dad1b2be">mapi_object::logon_id</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#aff3ad6ae2f56ce102be53059e51731fd">CloneStream()</a>, <a class="el" href="proto_8h.html#a9f7152a9db034fbf7cc7fa8e481bd226">CreateAttach()</a>, <a class="el" href="proto_8h.html#aa0d3c0451ce5f8584cce650ca3223b04">CreateFolder()</a>, <a class="el" href="proto_8h.html#acd2d9aaa13e6138886bacdcea51695d3">CreateMessage()</a>, <a class="el" href="proto_8h.html#a3323b8ace0a76a8f9e53aa989bc886c1">GetAttachmentTable()</a>, <a class="el" href="proto_8h.html#a8005a7edf302693a7277f1351382d0d5">GetContentsTable()</a>, <a class="el" href="proto_8h.html#ad5362cafba2a76a70b112c966abe5907">GetHierarchyTable()</a>, <a class="el" href="proto_8h.html#a7f0a6f074da61394f2cdeba437d8fc12">GetRulesTable()</a>, <a class="el" href="proto_8h.html#a0c8a9b8fc54139a1411aa9264acbe200">GetTable()</a>, <a class="el" href="proto_8h.html#a8af2fe9cc98605fbda054d3091499ed2">OpenAttach()</a>, <a class="el" href="proto_8h.html#aaf3088b3837b1908e6bb6b14f906a4e0">OpenEmbeddedMessage()</a>, <a class="el" href="proto_8h.html#a5d20a82a73d463254ac5e688f0f0cb0f">OpenFolder()</a>, <a class="el" href="proto_8h.html#a26b91ebe67489ca9e12a2ad1ba71548c">OpenMessage()</a>, <a class="el" href="proto_8h.html#ac27ee071a1b0d8344bb0320a4a647f54">OpenPublicFolder()</a>, <a class="el" href="proto_8h.html#a8fda02d0b93fae98d923a82d86ca8c6c">OpenPublicFolderByName()</a>, <a class="el" href="proto_8h.html#a2be8f10c82ffcf8070e105f1a0d8c998">OpenStream()</a>, and <a class="el" href="proto_8h.html#a7a2978c322cbed08f16de37682cdebde">OpenUserMailbox()</a>.</p>

</div>
</div>
<a class="anchor" id="a5ae14832b40db995554d07a2bbdb59fd"></a><!-- doxytag: member="mapi_object.c::mapi_object_set_logon_store" ref="a5ae14832b40db995554d07a2bbdb59fd" args="(mapi_object_t *obj)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ void mapi_object_set_logon_store </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Mark a MAPI object as a store object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer to the object to set the store boolean for </td></tr>
  </table>
  </dd>
</dl>

<p>References <a class="el" href="structmapi__object.html#ae7203e2fad471960c2dd25960cf585e8">mapi_object::store</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#ac27ee071a1b0d8344bb0320a4a647f54">OpenPublicFolder()</a>, and <a class="el" href="proto_8h.html#a7a2978c322cbed08f16de37682cdebde">OpenUserMailbox()</a>.</p>

</div>
</div>
<a class="anchor" id="a373e9bd46155ea22e816fa66944f22a6"></a><!-- doxytag: member="mapi_object.c::mapi_object_set_session" ref="a373e9bd46155ea22e816fa66944f22a6" args="(mapi_object_t *obj, struct mapi_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">_PUBLIC_ void mapi_object_set_session </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">struct <a class="el" href="structmapi__session.html">mapi_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set the session for a given MAPI object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>obj</em>&nbsp;</td><td>pointer on the object to set the session for </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>session</em>&nbsp;</td><td>pointer on the MAPI session to associate to the MAPI object </td></tr>
  </table>
  </dd>
</dl>

<p>References <a class="el" href="structmapi__object.html#a103d82b68de929c4ad9beedf05f8ac85">mapi_object::session</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#aff3ad6ae2f56ce102be53059e51731fd">CloneStream()</a>, <a class="el" href="proto_8h.html#a9f7152a9db034fbf7cc7fa8e481bd226">CreateAttach()</a>, <a class="el" href="proto_8h.html#aa0d3c0451ce5f8584cce650ca3223b04">CreateFolder()</a>, <a class="el" href="proto_8h.html#acd2d9aaa13e6138886bacdcea51695d3">CreateMessage()</a>, <a class="el" href="proto_8h.html#a3323b8ace0a76a8f9e53aa989bc886c1">GetAttachmentTable()</a>, <a class="el" href="proto_8h.html#a8005a7edf302693a7277f1351382d0d5">GetContentsTable()</a>, <a class="el" href="proto_8h.html#ad5362cafba2a76a70b112c966abe5907">GetHierarchyTable()</a>, <a class="el" href="proto_8h.html#a7f0a6f074da61394f2cdeba437d8fc12">GetRulesTable()</a>, <a class="el" href="proto_8h.html#a0c8a9b8fc54139a1411aa9264acbe200">GetTable()</a>, <a class="el" href="proto_8h.html#a8af2fe9cc98605fbda054d3091499ed2">OpenAttach()</a>, <a class="el" href="proto_8h.html#aaf3088b3837b1908e6bb6b14f906a4e0">OpenEmbeddedMessage()</a>, <a class="el" href="proto_8h.html#a5d20a82a73d463254ac5e688f0f0cb0f">OpenFolder()</a>, <a class="el" href="proto_8h.html#a26b91ebe67489ca9e12a2ad1ba71548c">OpenMessage()</a>, <a class="el" href="proto_8h.html#ac27ee071a1b0d8344bb0320a4a647f54">OpenPublicFolder()</a>, <a class="el" href="proto_8h.html#a8fda02d0b93fae98d923a82d86ca8c6c">OpenPublicFolderByName()</a>, <a class="el" href="proto_8h.html#a2be8f10c82ffcf8070e105f1a0d8c998">OpenStream()</a>, <a class="el" href="proto_8h.html#a7a2978c322cbed08f16de37682cdebde">OpenUserMailbox()</a>, and <a class="el" href="proto_8h.html#a73891d48327dd1afee64dba5b7cfddc0">Subscribe()</a>.</p>

</div>
</div>
<a class="anchor" id="a678facb39f5979fec7ad08f2659d5181"></a><!-- doxytag: member="mapi_object.c::mapi_object_table_init" ref="a678facb39f5979fec7ad08f2659d5181" args="(TALLOC_CTX *mem_ctx, mapi_object_t *obj_table)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void mapi_object_table_init </td>
          <td>(</td>
          <td class="paramtype">TALLOC_CTX *&nbsp;</td>
          <td class="paramname"> <em>mem_ctx</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structmapi__object.html">mapi_object_t</a> *&nbsp;</td>
          <td class="paramname"> <em>obj_table</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Initialize MAPI object private data to store a MAPI object table</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>&nbsp;</td><td>pointer on the memory context </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>obj_table</em>&nbsp;</td><td>pointer on the MAPI object </td></tr>
  </table>
  </dd>
</dl>

<p>References <a class="el" href="structmapi__obj__table.html#ae0c3a2497817f01d34a315ba9d37569d">mapi_obj_table::bk_last</a>, <a class="el" href="structmapi__obj__table.html#a6a29be7f089d4fe4da5fdf30f216942e">mapi_obj_table::bookmark</a>, <a class="el" href="structmapi__object.html#af33195293d914107863508deadcfba80">mapi_object::private_data</a>, and <a class="el" href="structmapi__obj__table.html#ae881a2d96cfcbb0c37bf0ddbbf635f35">mapi_obj_table::proptags</a>.</p>

<p>Referenced by <a class="el" href="proto_8h.html#a8005a7edf302693a7277f1351382d0d5">GetContentsTable()</a>, <a class="el" href="proto_8h.html#ad5362cafba2a76a70b112c966abe5907">GetHierarchyTable()</a>, <a class="el" href="proto_8h.html#a7f0a6f074da61394f2cdeba437d8fc12">GetRulesTable()</a>, and <a class="el" href="proto_8h.html#a0c8a9b8fc54139a1411aa9264acbe200">GetTable()</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>