← Back to branch summary

~ubuntu-branches/debian/jessie/openchange/jessie

« back to all changes in this revision

Viewing changes to apidocs/html/libmapi/IMAPIProp_8c.html

  • Committer: Package Import Robot
  • Author(s): Jelmer Vernooij
  • Date: 2014-04-24 00:29:19 UTC
  • mfrom: (1.2.8) (4.1.6 experimental)
  • Revision ID: package-import@ubuntu.com-20140424002919-96es5uhyy3jjzgid
Tags: 1:2.1-1
* New upstream release.
 + Stop removing broken manpages, upstream on longer installs them.
* Add upstream signing key.
* Run test suite during build.
 + Add dependency on python-twisted-core for trial and python-testtools.
 + Add fix-tests patch, cherry-picked from upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
apidocs/html/libmapi/IMAPIProp_8c.html
1
 
<html>
2
 
  <head>
3
 
    <title>MAPIClientLibraries 2.0 API Documentation</title>
4
 
    <link href="doxygen.css" rel="stylesheet" type="text/css"/>
5
 
    <link href="apidocs.css" rel="stylesheet" type="text/css"/>
6
 
  </head>
7
 
  <body>
8
 
    <div id="website">
9
 
    <div class="header"></div>
10
 
      <div id="middle_side">
11
 
        <div id="right_side_home">
12
 
<!-- Generated by Doxygen 1.8.1.2 -->
13
 
  <div id="navrow1" class="tabs">
14
 
    <ul class="tablist">
15
 
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
16
 
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
17
 
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
18
 
      <li class="current"><a href="files.html"><span>Files</span></a></li>
19
 
      <li><a href="examples.html"><span>Examples</span></a></li>
20
 
    </ul>
21
 
  </div>
22
 
  <div id="navrow2" class="tabs2">
23
 
    <ul class="tablist">
24
 
      <li><a href="files.html"><span>File&#160;List</span></a></li>
25
 
      <li><a href="globals.html"><span>Globals</span></a></li>
26
 
    </ul>
27
 
  </div>
28
 
<div id="nav-path" class="navpath">
29
 
  <ul>
30
 
<li class="navelem"><a class="el" href="dir_f632a44caec7a90b6d38c87e3df284e5.html">libmapi</a></li>  </ul>
31
 
</div>
32
 
</div><!-- top -->
33
 
<div class="header">
34
 
  <div class="summary">
35
 
<a href="#func-members">Functions</a>  </div>
36
 
  <div class="headertitle">
37
 
<div class="title">IMAPIProp.c File Reference</div>  </div>
38
 
</div><!--header-->
39
 
<div class="contents">
40
 
 
41
 
<p>Properties and named properties operations.  
42
 
<a href="#details">More...</a></p>
43
 
<div class="textblock"><code>#include &quot;libmapi/libmapi.h&quot;</code><br/>
44
 
</div><table class="memberdecls">
45
 
<tr class="heading"><td colspan="2"><h2><a name="func-members"></a>
46
 
Functions</h2></td></tr>
47
 
<tr class="memitem:a5ee9cbd64423c52c3d40df8658bb4648"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#a5ee9cbd64423c52c3d40df8658bb4648">CopyProps</a> (mapi_object_t *obj_src, mapi_object_t *obj_dst, struct SPropTagArray *tags, uint8_t copyFlags, uint16_t *problemCount, struct PropertyProblem **problems)</td></tr>
48
 
<tr class="memitem:afa8565f9bda2e4e522162fd851fead4f"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#afa8565f9bda2e4e522162fd851fead4f">CopyTo</a> (mapi_object_t *obj_src, mapi_object_t *obj_dst, struct SPropTagArray *excludeTags, uint8_t copyFlags, uint16_t *problemCount, struct PropertyProblem **problems)</td></tr>
49
 
<tr class="memitem:a729ca053b8f7a3bd7c6a299559c26053"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#a729ca053b8f7a3bd7c6a299559c26053">DeletePropertiesNoReplicate</a> (mapi_object_t *obj, struct SPropTagArray *proptags)</td></tr>
50
 
<tr class="memitem:ad7c939f4d2da811a8913e6563c9c98f3"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#ad7c939f4d2da811a8913e6563c9c98f3">DeleteProps</a> (mapi_object_t *obj, struct SPropTagArray *proptags)</td></tr>
51
 
<tr class="memitem:ac7a673fa38d4f737c5b1f8fa905f8155"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a> (mapi_object_t *obj, uint16_t count, struct MAPINAMEID *nameid, uint32_t ulFlags, struct SPropTagArray **proptags)</td></tr>
52
 
<tr class="memitem:a980b8bb8e01c3a4648b62add304db9a3"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#a980b8bb8e01c3a4648b62add304db9a3">GetNamesFromIDs</a> (mapi_object_t *obj, enum MAPITAGS ulPropTag, uint16_t *count, struct MAPINAMEID **nameid)</td></tr>
53
 
<tr class="memitem:a20913af3ef18646635530f5bd8021061"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#a20913af3ef18646635530f5bd8021061">GetPropList</a> (mapi_object_t *obj, struct SPropTagArray *proptags)</td></tr>
54
 
<tr class="memitem:ade217ac8248ec52af71705ae8df35d47"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#ade217ac8248ec52af71705ae8df35d47">GetProps</a> (mapi_object_t *obj, uint32_t flags, struct SPropTagArray *SPropTagArray, struct SPropValue **lpProps, uint32_t *PropCount)</td></tr>
55
 
<tr class="memitem:afbe1c87d25b06d68a23d14443645f1b1"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#afbe1c87d25b06d68a23d14443645f1b1">GetPropsAll</a> (mapi_object_t *obj, uint32_t flags, struct mapi_SPropValue_array *properties)</td></tr>
56
 
<tr class="memitem:aa27de452605d7989c8c2686cee7780b7"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#aa27de452605d7989c8c2686cee7780b7">QueryNamedProperties</a> (mapi_object_t *obj, uint8_t queryFlags, struct GUID *guid, uint16_t *count, uint16_t **propID, struct MAPINAMEID **nameid)</td></tr>
57
 
<tr class="memitem:ac2ac74760d05cc2663b5a95c4d57e5e0"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#ac2ac74760d05cc2663b5a95c4d57e5e0">SaveChangesAttachment</a> (mapi_object_t *obj_parent, mapi_object_t *obj_child, enum SaveFlags flags)</td></tr>
58
 
<tr class="memitem:a5132fc4cccdbf65b9156fe1ae6bb187f"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#a5132fc4cccdbf65b9156fe1ae6bb187f">SetPropertiesNoReplicate</a> (mapi_object_t *obj, uint32_t flags, struct SPropValue *lpProps, unsigned long PropCount)</td></tr>
59
 
<tr class="memitem:a493019f7bf3431d246b1e3a6b3114084"><td class="memItemLeft" align="right" valign="top">_PUBLIC_ enum MAPISTATUS&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="IMAPIProp_8c.html#a493019f7bf3431d246b1e3a6b3114084">SetProps</a> (mapi_object_t *obj, uint32_t flags, struct SPropValue *lpProps, unsigned long PropCount)</td></tr>
60
 
</table>
61
 
<a name="details" id="details"></a><h2>Detailed Description</h2>
62
 
<div class="textblock"><p>Properties and named properties operations. </p>
63
 
</div><h2>Function Documentation</h2>
64
 
<a class="anchor" id="a5ee9cbd64423c52c3d40df8658bb4648"></a>
65
 
<div class="memitem">
66
 
<div class="memproto">
67
 
      <table class="memname">
68
 
        <tr>
69
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS CopyProps </td>
70
 
          <td>(</td>
71
 
          <td class="paramtype">mapi_object_t *&#160;</td>
72
 
          <td class="paramname"><em>obj_src</em>, </td>
73
 
        </tr>
74
 
        <tr>
75
 
          <td class="paramkey"></td>
76
 
          <td></td>
77
 
          <td class="paramtype">mapi_object_t *&#160;</td>
78
 
          <td class="paramname"><em>obj_dst</em>, </td>
79
 
        </tr>
80
 
        <tr>
81
 
          <td class="paramkey"></td>
82
 
          <td></td>
83
 
          <td class="paramtype">struct SPropTagArray *&#160;</td>
84
 
          <td class="paramname"><em>tags</em>, </td>
85
 
        </tr>
86
 
        <tr>
87
 
          <td class="paramkey"></td>
88
 
          <td></td>
89
 
          <td class="paramtype">uint8_t&#160;</td>
90
 
          <td class="paramname"><em>copyFlags</em>, </td>
91
 
        </tr>
92
 
        <tr>
93
 
          <td class="paramkey"></td>
94
 
          <td></td>
95
 
          <td class="paramtype">uint16_t *&#160;</td>
96
 
          <td class="paramname"><em>problemCount</em>, </td>
97
 
        </tr>
98
 
        <tr>
99
 
          <td class="paramkey"></td>
100
 
          <td></td>
101
 
          <td class="paramtype">struct PropertyProblem **&#160;</td>
102
 
          <td class="paramname"><em>problems</em>&#160;</td>
103
 
        </tr>
104
 
        <tr>
105
 
          <td></td>
106
 
          <td>)</td>
107
 
          <td></td><td></td>
108
 
        </tr>
109
 
      </table>
110
 
</div><div class="memdoc">
111
 
<p>Copy properties from one object to another</p>
112
 
<p>This function copies (or moves) specified properties from one object to another.</p>
113
 
<dl class="params"><dt>Parameters</dt><dd>
114
 
  <table class="params">
115
 
    <tr><td class="paramname">obj_src</td><td>the object to copy properties from </td></tr>
116
 
    <tr><td class="paramname">obj_dst</td><td>the object to set properties on </td></tr>
117
 
    <tr><td class="paramname">copyFlags</td><td>flags to determine whether to copy or move, and whether to overwrite existing properties. </td></tr>
118
 
    <tr><td class="paramname">tags</td><td>the list of properties to copy </td></tr>
119
 
    <tr><td class="paramname">problemCount</td><td>(return value) number of entries in the problems array </td></tr>
120
 
    <tr><td class="paramname">problems</td><td>(return value) array of problemCount entries.</td></tr>
121
 
  </table>
122
 
  </dd>
123
 
</dl>
124
 
<p>The caller is responsible for freeing the <b>problems</b> array using <a class="el" href="IUnknown_8c.html#a52246b3bbc755db550d9d13e772dd479">MAPIFreeBuffer()</a>. If the <b>problemCount</b> pointer is NULL, then the problems array will not be returned.</p>
125
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
126
 
<dl class="section note"><dt>Note</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>
127
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
128
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
129
 
</ul>
130
 
</dd></dl>
131
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#ade217ac8248ec52af71705ae8df35d47">GetProps</a>, <a class="el" href="IMAPIProp_8c.html#a493019f7bf3431d246b1e3a6b3114084">SetProps</a>, <a class="el" href="IMAPIProp_8c.html#ad7c939f4d2da811a8913e6563c9c98f3">DeleteProps</a>, <a class="el" href="IMAPIProp_8c.html#afa8565f9bda2e4e522162fd851fead4f">CopyTo</a>, <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError</a> </dd></dl>
132
 
 
133
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
134
 
 
135
 
</div>
136
 
</div>
137
 
<a class="anchor" id="afa8565f9bda2e4e522162fd851fead4f"></a>
138
 
<div class="memitem">
139
 
<div class="memproto">
140
 
      <table class="memname">
141
 
        <tr>
142
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS CopyTo </td>
143
 
          <td>(</td>
144
 
          <td class="paramtype">mapi_object_t *&#160;</td>
145
 
          <td class="paramname"><em>obj_src</em>, </td>
146
 
        </tr>
147
 
        <tr>
148
 
          <td class="paramkey"></td>
149
 
          <td></td>
150
 
          <td class="paramtype">mapi_object_t *&#160;</td>
151
 
          <td class="paramname"><em>obj_dst</em>, </td>
152
 
        </tr>
153
 
        <tr>
154
 
          <td class="paramkey"></td>
155
 
          <td></td>
156
 
          <td class="paramtype">struct SPropTagArray *&#160;</td>
157
 
          <td class="paramname"><em>excludeTags</em>, </td>
158
 
        </tr>
159
 
        <tr>
160
 
          <td class="paramkey"></td>
161
 
          <td></td>
162
 
          <td class="paramtype">uint8_t&#160;</td>
163
 
          <td class="paramname"><em>copyFlags</em>, </td>
164
 
        </tr>
165
 
        <tr>
166
 
          <td class="paramkey"></td>
167
 
          <td></td>
168
 
          <td class="paramtype">uint16_t *&#160;</td>
169
 
          <td class="paramname"><em>problemCount</em>, </td>
170
 
        </tr>
171
 
        <tr>
172
 
          <td class="paramkey"></td>
173
 
          <td></td>
174
 
          <td class="paramtype">struct PropertyProblem **&#160;</td>
175
 
          <td class="paramname"><em>problems</em>&#160;</td>
176
 
        </tr>
177
 
        <tr>
178
 
          <td></td>
179
 
          <td>)</td>
180
 
          <td></td><td></td>
181
 
        </tr>
182
 
      </table>
183
 
</div><div class="memdoc">
184
 
<p>Copy multiple properties from one object to another</p>
185
 
<p>This function copies (or moves) properties from one object to another. Unlike CopyProperties, this function copies all properties except those identified.</p>
186
 
<dl class="params"><dt>Parameters</dt><dd>
187
 
  <table class="params">
188
 
    <tr><td class="paramname">obj_src</td><td>the object to copy properties from </td></tr>
189
 
    <tr><td class="paramname">obj_dst</td><td>the object to set properties on </td></tr>
190
 
    <tr><td class="paramname">excludeTags</td><td>the list of properties to <em>not</em> copy </td></tr>
191
 
    <tr><td class="paramname">copyFlags</td><td>flags to determine whether to copy or move, and whether to overwrite existing properties. </td></tr>
192
 
    <tr><td class="paramname">problemCount</td><td>(return value) number of entries in the problems array </td></tr>
193
 
    <tr><td class="paramname">problems</td><td>(return value) array of problemCount entries.</td></tr>
194
 
  </table>
195
 
  </dd>
196
 
</dl>
197
 
<p>The caller is responsible for freeing the <b>problems</b> array using <a class="el" href="IUnknown_8c.html#a52246b3bbc755db550d9d13e772dd479">MAPIFreeBuffer()</a>. If the <b>problemCount</b> pointer is NULL, then the problems array will not be returned.</p>
198
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
199
 
<dl class="section note"><dt>Note</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>
200
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
201
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
202
 
</ul>
203
 
</dd></dl>
204
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#ade217ac8248ec52af71705ae8df35d47">GetProps</a>, <a class="el" href="IMAPIProp_8c.html#a493019f7bf3431d246b1e3a6b3114084">SetProps</a>, <a class="el" href="IMAPIProp_8c.html#ad7c939f4d2da811a8913e6563c9c98f3">DeleteProps</a>, <a class="el" href="IMAPIProp_8c.html#a5ee9cbd64423c52c3d40df8658bb4648">CopyProps</a> </dd></dl>
205
 
 
206
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
207
 
 
208
 
</div>
209
 
</div>
210
 
<a class="anchor" id="a729ca053b8f7a3bd7c6a299559c26053"></a>
211
 
<div class="memitem">
212
 
<div class="memproto">
213
 
      <table class="memname">
214
 
        <tr>
215
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS DeletePropertiesNoReplicate </td>
216
 
          <td>(</td>
217
 
          <td class="paramtype">mapi_object_t *&#160;</td>
218
 
          <td class="paramname"><em>obj</em>, </td>
219
 
        </tr>
220
 
        <tr>
221
 
          <td class="paramkey"></td>
222
 
          <td></td>
223
 
          <td class="paramtype">struct SPropTagArray *&#160;</td>
224
 
          <td class="paramname"><em>proptags</em>&#160;</td>
225
 
        </tr>
226
 
        <tr>
227
 
          <td></td>
228
 
          <td>)</td>
229
 
          <td></td><td></td>
230
 
        </tr>
231
 
      </table>
232
 
</div><div class="memdoc">
233
 
<p>Deletes property values from an object without invoking replication.</p>
234
 
<dl class="params"><dt>Parameters</dt><dd>
235
 
  <table class="params">
236
 
    <tr><td class="paramname">obj</td><td>the object to remove properties from </td></tr>
237
 
    <tr><td class="paramname">proptags</td><td>the properties to remove from the given object</td></tr>
238
 
  </table>
239
 
  </dd>
240
 
</dl>
241
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
242
 
<dl class="section note"><dt>Note</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>
243
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
244
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
245
 
</ul>
246
 
</dd></dl>
247
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#ad7c939f4d2da811a8913e6563c9c98f3">DeleteProps</a> </dd></dl>
248
 
 
249
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
250
 
 
251
 
</div>
252
 
</div>
253
 
<a class="anchor" id="ad7c939f4d2da811a8913e6563c9c98f3"></a>
254
 
<div class="memitem">
255
 
<div class="memproto">
256
 
      <table class="memname">
257
 
        <tr>
258
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS DeleteProps </td>
259
 
          <td>(</td>
260
 
          <td class="paramtype">mapi_object_t *&#160;</td>
261
 
          <td class="paramname"><em>obj</em>, </td>
262
 
        </tr>
263
 
        <tr>
264
 
          <td class="paramkey"></td>
265
 
          <td></td>
266
 
          <td class="paramtype">struct SPropTagArray *&#160;</td>
267
 
          <td class="paramname"><em>proptags</em>&#160;</td>
268
 
        </tr>
269
 
        <tr>
270
 
          <td></td>
271
 
          <td>)</td>
272
 
          <td></td><td></td>
273
 
        </tr>
274
 
      </table>
275
 
</div><div class="memdoc">
276
 
<p>Delete one or more properties from an object</p>
277
 
<dl class="params"><dt>Parameters</dt><dd>
278
 
  <table class="params">
279
 
    <tr><td class="paramname">obj</td><td>the object to remove properties from </td></tr>
280
 
    <tr><td class="paramname">proptags</td><td>the properties to remove from the given object</td></tr>
281
 
  </table>
282
 
  </dd>
283
 
</dl>
284
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
285
 
<dl class="section note"><dt>Note</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>
286
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
287
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
288
 
</ul>
289
 
</dd></dl>
290
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#a493019f7bf3431d246b1e3a6b3114084">SetProps</a>, <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError</a> </dd></dl>
291
 
 
292
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
293
 
 
294
 
</div>
295
 
</div>
296
 
<a class="anchor" id="ac7a673fa38d4f737c5b1f8fa905f8155"></a>
297
 
<div class="memitem">
298
 
<div class="memproto">
299
 
      <table class="memname">
300
 
        <tr>
301
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS GetIDsFromNames </td>
302
 
          <td>(</td>
303
 
          <td class="paramtype">mapi_object_t *&#160;</td>
304
 
          <td class="paramname"><em>obj</em>, </td>
305
 
        </tr>
306
 
        <tr>
307
 
          <td class="paramkey"></td>
308
 
          <td></td>
309
 
          <td class="paramtype">uint16_t&#160;</td>
310
 
          <td class="paramname"><em>count</em>, </td>
311
 
        </tr>
312
 
        <tr>
313
 
          <td class="paramkey"></td>
314
 
          <td></td>
315
 
          <td class="paramtype">struct MAPINAMEID *&#160;</td>
316
 
          <td class="paramname"><em>nameid</em>, </td>
317
 
        </tr>
318
 
        <tr>
319
 
          <td class="paramkey"></td>
320
 
          <td></td>
321
 
          <td class="paramtype">uint32_t&#160;</td>
322
 
          <td class="paramname"><em>ulFlags</em>, </td>
323
 
        </tr>
324
 
        <tr>
325
 
          <td class="paramkey"></td>
326
 
          <td></td>
327
 
          <td class="paramtype">struct SPropTagArray **&#160;</td>
328
 
          <td class="paramname"><em>proptags</em>&#160;</td>
329
 
        </tr>
330
 
        <tr>
331
 
          <td></td>
332
 
          <td>)</td>
333
 
          <td></td><td></td>
334
 
        </tr>
335
 
      </table>
336
 
</div><div class="memdoc">
337
 
<p>Provides the property identifiers that correspond to one or more property names.</p>
338
 
<dl class="params"><dt>Parameters</dt><dd>
339
 
  <table class="params">
340
 
    <tr><td class="paramname">obj</td><td>the object we are retrieving the identifiers from </td></tr>
341
 
    <tr><td class="paramname">count</td><td>count of property names pointed to by the nameid parameter. </td></tr>
342
 
    <tr><td class="paramname">nameid</td><td>pointer to an array of property names </td></tr>
343
 
    <tr><td class="paramname">ulFlags</td><td>indicates how the property identifiers should be returned </td></tr>
344
 
    <tr><td class="paramname">proptags</td><td>pointer to a pointer to an array of property tags containing existing or newly assigned property identifiers. Property types in this array are set to PT_NULL.</td></tr>
345
 
  </table>
346
 
  </dd>
347
 
</dl>
348
 
<p>ulFlags can be set to:</p>
349
 
<ul>
350
 
<li>0 retrieves named properties from the server</li>
351
 
<li>MAPI_CREATE create the named properties if they don't exist on the server</li>
352
 
</ul>
353
 
<dl class="section note"><dt>Note</dt><dd>count and nameid parameter can automatically be built using the mapi_nameid API.</dd></dl>
354
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
355
 
<dl class="section note"><dt>Note</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>
356
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
357
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
358
 
</ul>
359
 
</dd></dl>
360
 
<dl class="section see"><dt>See Also</dt><dd>GetNamesFromIds, QueryNamesFromIDs, <a class="el" href="mapi__nameid_8c.html#a7705209e3f79f856778b900123159f80">mapi_nameid_new</a> </dd></dl>
361
 
 
362
 
<p>References <a class="el" href="property_8c.html#a41cb1aa9af66195a07acea1d0f848a3a">get_utf8_utf16_conv_length()</a>, <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
363
 
 
364
 
<p>Referenced by <a class="el" href="IMAPIProp_8c.html#ade217ac8248ec52af71705ae8df35d47">GetProps()</a>, <a class="el" href="mapi__nameid_8c.html#a6c24860883850bc1cb7acc5350dc6b4b">mapi_nameid_GetIDsFromNames()</a>, <a class="el" href="IMAPIProp_8c.html#a5132fc4cccdbf65b9156fe1ae6bb187f">SetPropertiesNoReplicate()</a>, and <a class="el" href="IMAPIProp_8c.html#a493019f7bf3431d246b1e3a6b3114084">SetProps()</a>.</p>
365
 
 
366
 
</div>
367
 
</div>
368
 
<a class="anchor" id="a980b8bb8e01c3a4648b62add304db9a3"></a>
369
 
<div class="memitem">
370
 
<div class="memproto">
371
 
      <table class="memname">
372
 
        <tr>
373
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS GetNamesFromIDs </td>
374
 
          <td>(</td>
375
 
          <td class="paramtype">mapi_object_t *&#160;</td>
376
 
          <td class="paramname"><em>obj</em>, </td>
377
 
        </tr>
378
 
        <tr>
379
 
          <td class="paramkey"></td>
380
 
          <td></td>
381
 
          <td class="paramtype">enum MAPITAGS&#160;</td>
382
 
          <td class="paramname"><em>ulPropTag</em>, </td>
383
 
        </tr>
384
 
        <tr>
385
 
          <td class="paramkey"></td>
386
 
          <td></td>
387
 
          <td class="paramtype">uint16_t *&#160;</td>
388
 
          <td class="paramname"><em>count</em>, </td>
389
 
        </tr>
390
 
        <tr>
391
 
          <td class="paramkey"></td>
392
 
          <td></td>
393
 
          <td class="paramtype">struct MAPINAMEID **&#160;</td>
394
 
          <td class="paramname"><em>nameid</em>&#160;</td>
395
 
        </tr>
396
 
        <tr>
397
 
          <td></td>
398
 
          <td>)</td>
399
 
          <td></td><td></td>
400
 
        </tr>
401
 
      </table>
402
 
</div><div class="memdoc">
403
 
<p>Provides the property names that correspond to one or more property identifiers.</p>
404
 
<dl class="params"><dt>Parameters</dt><dd>
405
 
  <table class="params">
406
 
    <tr><td class="paramname">obj</td><td>the object we are retrieving the names from </td></tr>
407
 
    <tr><td class="paramname">ulPropTag</td><td>the mapped property tag </td></tr>
408
 
    <tr><td class="paramname">count</td><td>count of property names pointed to by the nameid parameter returned by the server </td></tr>
409
 
    <tr><td class="paramname">nameid</td><td>pointer to a pointer to property names returned by the server</td></tr>
410
 
  </table>
411
 
  </dd>
412
 
</dl>
413
 
<p>ulPropTag must be a property with type set to PT_NULL</p>
414
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
415
 
<dl class="section note"><dt>Note</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>
416
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
417
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
418
 
</ul>
419
 
</dd></dl>
420
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames</a>, QueryNamesFromIDs </dd></dl>
421
 
 
422
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
423
 
 
424
 
</div>
425
 
</div>
426
 
<a class="anchor" id="a20913af3ef18646635530f5bd8021061"></a>
427
 
<div class="memitem">
428
 
<div class="memproto">
429
 
      <table class="memname">
430
 
        <tr>
431
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS GetPropList </td>
432
 
          <td>(</td>
433
 
          <td class="paramtype">mapi_object_t *&#160;</td>
434
 
          <td class="paramname"><em>obj</em>, </td>
435
 
        </tr>
436
 
        <tr>
437
 
          <td class="paramkey"></td>
438
 
          <td></td>
439
 
          <td class="paramtype">struct SPropTagArray *&#160;</td>
440
 
          <td class="paramname"><em>proptags</em>&#160;</td>
441
 
        </tr>
442
 
        <tr>
443
 
          <td></td>
444
 
          <td>)</td>
445
 
          <td></td><td></td>
446
 
        </tr>
447
 
      </table>
448
 
</div><div class="memdoc">
449
 
<p>Retrieve all the properties associated with a given object</p>
450
 
<dl class="params"><dt>Parameters</dt><dd>
451
 
  <table class="params">
452
 
    <tr><td class="paramname">obj</td><td>the object to retrieve properties for </td></tr>
453
 
    <tr><td class="paramname">proptags</td><td>the resulting list of properties associated with the object</td></tr>
454
 
  </table>
455
 
  </dd>
456
 
</dl>
457
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
458
 
<dl class="section note"><dt>Note</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>
459
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
460
 
<li><p class="startli">MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</p>
461
 
<p class="startli">The developer MUST provide an allocated SPropTagArray structure to the function.</p>
462
 
</li>
463
 
</ul>
464
 
</dd></dl>
465
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#ade217ac8248ec52af71705ae8df35d47">GetProps</a>, <a class="el" href="IMAPIProp_8c.html#afbe1c87d25b06d68a23d14443645f1b1">GetPropsAll</a>, <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError</a> </dd></dl>
466
 
 
467
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
468
 
 
469
 
</div>
470
 
</div>
471
 
<a class="anchor" id="ade217ac8248ec52af71705ae8df35d47"></a>
472
 
<div class="memitem">
473
 
<div class="memproto">
474
 
      <table class="memname">
475
 
        <tr>
476
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS GetProps </td>
477
 
          <td>(</td>
478
 
          <td class="paramtype">mapi_object_t *&#160;</td>
479
 
          <td class="paramname"><em>obj</em>, </td>
480
 
        </tr>
481
 
        <tr>
482
 
          <td class="paramkey"></td>
483
 
          <td></td>
484
 
          <td class="paramtype">uint32_t&#160;</td>
485
 
          <td class="paramname"><em>flags</em>, </td>
486
 
        </tr>
487
 
        <tr>
488
 
          <td class="paramkey"></td>
489
 
          <td></td>
490
 
          <td class="paramtype">struct SPropTagArray *&#160;</td>
491
 
          <td class="paramname"><em>SPropTagArray</em>, </td>
492
 
        </tr>
493
 
        <tr>
494
 
          <td class="paramkey"></td>
495
 
          <td></td>
496
 
          <td class="paramtype">struct SPropValue **&#160;</td>
497
 
          <td class="paramname"><em>lpProps</em>, </td>
498
 
        </tr>
499
 
        <tr>
500
 
          <td class="paramkey"></td>
501
 
          <td></td>
502
 
          <td class="paramtype">uint32_t *&#160;</td>
503
 
          <td class="paramname"><em>PropCount</em>&#160;</td>
504
 
        </tr>
505
 
        <tr>
506
 
          <td></td>
507
 
          <td>)</td>
508
 
          <td></td><td></td>
509
 
        </tr>
510
 
      </table>
511
 
</div><div class="memdoc">
512
 
<p>Returns values of one or more properties for an object</p>
513
 
<p>The function takes a pointer on the object obj, a MAPITAGS array specified in mapitags, and the count of properties. The function returns associated values within the SPropValue values pointer.</p>
514
 
<p>The array of MAPI property tags can be filled with both known and named properties.</p>
515
 
<dl class="params"><dt>Parameters</dt><dd>
516
 
  <table class="params">
517
 
    <tr><td class="paramname">obj</td><td>the object to get properties on </td></tr>
518
 
    <tr><td class="paramname">flags</td><td>Flags for behaviour; can be bit-OR of MAPI_UNICODE and MAPI_PROPS_SKIP_NAMEDID_CHECK constants </td></tr>
519
 
    <tr><td class="paramname">SPropTagArray</td><td>an array of MAPI property tags </td></tr>
520
 
    <tr><td class="paramname">lpProps</td><td>the result of the query </td></tr>
521
 
    <tr><td class="paramname">PropCount</td><td>the count of property tags</td></tr>
522
 
  </table>
523
 
  </dd>
524
 
</dl>
525
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
526
 
<dl class="section note"><dt>Note</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>
527
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
528
 
<li>MAPI_E_INVALID_PARAMETER: obj or SPropTagArray are null, or the session context could not be obtained</li>
529
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
530
 
</ul>
531
 
</dd></dl>
532
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#a493019f7bf3431d246b1e3a6b3114084">SetProps</a>, <a class="el" href="IMAPIProp_8c.html#a20913af3ef18646635530f5bd8021061">GetPropList</a>, <a class="el" href="IMAPIProp_8c.html#afbe1c87d25b06d68a23d14443645f1b1">GetPropsAll</a>, <a class="el" href="IMAPIProp_8c.html#ad7c939f4d2da811a8913e6563c9c98f3">DeleteProps</a>, <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError</a> </dd></dl>
533
 
 
534
 
<p>References <a class="el" href="emsmdb_8c.html#ac88ab5dc715b30732166cfef14cb1dd8">emsmdb_get_SPropValue()</a>, <a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a>, <a class="el" href="mapi__nameid_8c.html#af7418bf978061721530b5f8fb8940694">mapi_nameid_lookup_SPropTagArray()</a>, <a class="el" href="mapi__nameid_8c.html#a8662ee1914917df779ebf854361fb0bf">mapi_nameid_map_SPropTagArray()</a>, <a class="el" href="mapi__nameid_8c.html#a7705209e3f79f856778b900123159f80">mapi_nameid_new()</a>, <a class="el" href="mapi__nameid_8c.html#ad4237bda2484c14ee13fa7f2f5681345">mapi_nameid_unmap_SPropTagArray()</a>, <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>, and <a class="el" href="IUnknown_8c.html#a52246b3bbc755db550d9d13e772dd479">MAPIFreeBuffer()</a>.</p>
535
 
 
536
 
<p>Referenced by <a class="el" href="utils_8c.html#a01d9de5c2de79ccdc0aa9a8a482e8a32">EntryIDFromSourceIDForMessage()</a>, <a class="el" href="simple__mapi_8c.html#ac77ec981ccaa328f0fd1c9cdc03ae153">GetBestBody()</a>, <a class="el" href="simple__mapi_8c.html#a7b3fc634875a5d59ea50a4b8f0b11074">GetFolderItemsCount()</a>, and <a class="el" href="freebusy_8c.html#ab96741fc9618726a6eedc08c8813671e">GetUserFreeBusyData()</a>.</p>
537
 
 
538
 
</div>
539
 
</div>
540
 
<a class="anchor" id="afbe1c87d25b06d68a23d14443645f1b1"></a>
541
 
<div class="memitem">
542
 
<div class="memproto">
543
 
      <table class="memname">
544
 
        <tr>
545
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS GetPropsAll </td>
546
 
          <td>(</td>
547
 
          <td class="paramtype">mapi_object_t *&#160;</td>
548
 
          <td class="paramname"><em>obj</em>, </td>
549
 
        </tr>
550
 
        <tr>
551
 
          <td class="paramkey"></td>
552
 
          <td></td>
553
 
          <td class="paramtype">uint32_t&#160;</td>
554
 
          <td class="paramname"><em>flags</em>, </td>
555
 
        </tr>
556
 
        <tr>
557
 
          <td class="paramkey"></td>
558
 
          <td></td>
559
 
          <td class="paramtype">struct mapi_SPropValue_array *&#160;</td>
560
 
          <td class="paramname"><em>properties</em>&#160;</td>
561
 
        </tr>
562
 
        <tr>
563
 
          <td></td>
564
 
          <td>)</td>
565
 
          <td></td><td></td>
566
 
        </tr>
567
 
      </table>
568
 
</div><div class="memdoc">
569
 
<p>Retrieve all properties and values associated with an object</p>
570
 
<p>This function returns all the properties and and associated values for a given object.</p>
571
 
<dl class="params"><dt>Parameters</dt><dd>
572
 
  <table class="params">
573
 
    <tr><td class="paramname">obj</td><td>the object to get the properties for </td></tr>
574
 
    <tr><td class="paramname">flags</td><td>Flags for behaviour; can be a MAPI_UNICODE constant </td></tr>
575
 
    <tr><td class="paramname">properties</td><td>the properties / values for the object</td></tr>
576
 
  </table>
577
 
  </dd>
578
 
</dl>
579
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
580
 
<dl class="section note"><dt>Note</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>
581
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
582
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
583
 
</ul>
584
 
</dd></dl>
585
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#ade217ac8248ec52af71705ae8df35d47">GetProps</a>, <a class="el" href="IMAPIProp_8c.html#a20913af3ef18646635530f5bd8021061">GetPropList</a>, <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError</a> </dd></dl>
586
 
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="fetchappointment_8c-example.html#a14">fetchappointment.c</a>, and <a class="el" href="fetchmail_8c-example.html#a14">fetchmail.c</a>.</dd>
587
 
</dl>
588
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
589
 
 
590
 
</div>
591
 
</div>
592
 
<a class="anchor" id="aa27de452605d7989c8c2686cee7780b7"></a>
593
 
<div class="memitem">
594
 
<div class="memproto">
595
 
      <table class="memname">
596
 
        <tr>
597
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS QueryNamedProperties </td>
598
 
          <td>(</td>
599
 
          <td class="paramtype">mapi_object_t *&#160;</td>
600
 
          <td class="paramname"><em>obj</em>, </td>
601
 
        </tr>
602
 
        <tr>
603
 
          <td class="paramkey"></td>
604
 
          <td></td>
605
 
          <td class="paramtype">uint8_t&#160;</td>
606
 
          <td class="paramname"><em>queryFlags</em>, </td>
607
 
        </tr>
608
 
        <tr>
609
 
          <td class="paramkey"></td>
610
 
          <td></td>
611
 
          <td class="paramtype">struct GUID *&#160;</td>
612
 
          <td class="paramname"><em>guid</em>, </td>
613
 
        </tr>
614
 
        <tr>
615
 
          <td class="paramkey"></td>
616
 
          <td></td>
617
 
          <td class="paramtype">uint16_t *&#160;</td>
618
 
          <td class="paramname"><em>count</em>, </td>
619
 
        </tr>
620
 
        <tr>
621
 
          <td class="paramkey"></td>
622
 
          <td></td>
623
 
          <td class="paramtype">uint16_t **&#160;</td>
624
 
          <td class="paramname"><em>propID</em>, </td>
625
 
        </tr>
626
 
        <tr>
627
 
          <td class="paramkey"></td>
628
 
          <td></td>
629
 
          <td class="paramtype">struct MAPINAMEID **&#160;</td>
630
 
          <td class="paramname"><em>nameid</em>&#160;</td>
631
 
        </tr>
632
 
        <tr>
633
 
          <td></td>
634
 
          <td>)</td>
635
 
          <td></td><td></td>
636
 
        </tr>
637
 
      </table>
638
 
</div><div class="memdoc">
639
 
<p>Provides the property names that correspond to one or more property identifiers.</p>
640
 
<dl class="params"><dt>Parameters</dt><dd>
641
 
  <table class="params">
642
 
    <tr><td class="paramname">obj</td><td>the object to obtain the properties for </td></tr>
643
 
    <tr><td class="paramname">queryFlags</td><td>A set of flags that can restrict the type of properties </td></tr>
644
 
    <tr><td class="paramname">guid</td><td>a pointer to the GUID for the property set to fetch (null for all property sets. </td></tr>
645
 
    <tr><td class="paramname">count</td><td>count of property names pointed to by the nameid and propID parameters returned by the server </td></tr>
646
 
    <tr><td class="paramname">propID</td><td>pointer to an array of property IDs returned by the server </td></tr>
647
 
    <tr><td class="paramname">nameid</td><td>pointer to an array of property names returned by the server</td></tr>
648
 
  </table>
649
 
  </dd>
650
 
</dl>
651
 
<dl class="section note"><dt>Note</dt><dd>queryFlags can be NoStrings (0x1) or NoIds (0x2), neither or both. NoStrings will produce only ID properties, NoIds will produce only named properties, and both will result in no output.</dd></dl>
652
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
653
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#a980b8bb8e01c3a4648b62add304db9a3">GetNamesFromIDs</a> </dd></dl>
654
 
 
655
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
656
 
 
657
 
</div>
658
 
</div>
659
 
<a class="anchor" id="ac2ac74760d05cc2663b5a95c4d57e5e0"></a>
660
 
<div class="memitem">
661
 
<div class="memproto">
662
 
      <table class="memname">
663
 
        <tr>
664
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS SaveChangesAttachment </td>
665
 
          <td>(</td>
666
 
          <td class="paramtype">mapi_object_t *&#160;</td>
667
 
          <td class="paramname"><em>obj_parent</em>, </td>
668
 
        </tr>
669
 
        <tr>
670
 
          <td class="paramkey"></td>
671
 
          <td></td>
672
 
          <td class="paramtype">mapi_object_t *&#160;</td>
673
 
          <td class="paramname"><em>obj_child</em>, </td>
674
 
        </tr>
675
 
        <tr>
676
 
          <td class="paramkey"></td>
677
 
          <td></td>
678
 
          <td class="paramtype">enum SaveFlags&#160;</td>
679
 
          <td class="paramname"><em>flags</em>&#160;</td>
680
 
        </tr>
681
 
        <tr>
682
 
          <td></td>
683
 
          <td>)</td>
684
 
          <td></td><td></td>
685
 
        </tr>
686
 
      </table>
687
 
</div><div class="memdoc">
688
 
<p>Makes permanent any changes made to an attachment since the last save operation.</p>
689
 
<dl class="params"><dt>Parameters</dt><dd>
690
 
  <table class="params">
691
 
    <tr><td class="paramname">obj_parent</td><td>the parent of the object to save changes for </td></tr>
692
 
    <tr><td class="paramname">obj_child</td><td>the object to save changes for </td></tr>
693
 
    <tr><td class="paramname">flags</td><td>the access flags to set on the saved object</td></tr>
694
 
  </table>
695
 
  </dd>
696
 
</dl>
697
 
<p>Possible flags:</p>
698
 
<ul>
699
 
<li>KeepOpenReadOnly</li>
700
 
<li>KeepOpenReadWrite</li>
701
 
<li>ForceSave</li>
702
 
</ul>
703
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
704
 
<dl class="section note"><dt>Note</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>
705
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
706
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
707
 
</ul>
708
 
</dd></dl>
709
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#a493019f7bf3431d246b1e3a6b3114084">SetProps</a>, <a class="el" href="IMessage_8c.html#a2631355714b42d3d972113372c5175e0">ModifyRecipients</a>, <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError</a> </dd></dl>
710
 
 
711
 
<p>References <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, and <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>.</p>
712
 
 
713
 
</div>
714
 
</div>
715
 
<a class="anchor" id="a5132fc4cccdbf65b9156fe1ae6bb187f"></a>
716
 
<div class="memitem">
717
 
<div class="memproto">
718
 
      <table class="memname">
719
 
        <tr>
720
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS SetPropertiesNoReplicate </td>
721
 
          <td>(</td>
722
 
          <td class="paramtype">mapi_object_t *&#160;</td>
723
 
          <td class="paramname"><em>obj</em>, </td>
724
 
        </tr>
725
 
        <tr>
726
 
          <td class="paramkey"></td>
727
 
          <td></td>
728
 
          <td class="paramtype">uint32_t&#160;</td>
729
 
          <td class="paramname"><em>flags</em>, </td>
730
 
        </tr>
731
 
        <tr>
732
 
          <td class="paramkey"></td>
733
 
          <td></td>
734
 
          <td class="paramtype">struct SPropValue *&#160;</td>
735
 
          <td class="paramname"><em>lpProps</em>, </td>
736
 
        </tr>
737
 
        <tr>
738
 
          <td class="paramkey"></td>
739
 
          <td></td>
740
 
          <td class="paramtype">unsigned long&#160;</td>
741
 
          <td class="paramname"><em>PropCount</em>&#160;</td>
742
 
        </tr>
743
 
        <tr>
744
 
          <td></td>
745
 
          <td>)</td>
746
 
          <td></td><td></td>
747
 
        </tr>
748
 
      </table>
749
 
</div><div class="memdoc">
750
 
<p>Set one or more properties on a given object without invoking replication.</p>
751
 
<p>This function sets one or more properties on a specified object. It is the same as SetProps, except if the object is a folder, where this function does not result in folder properties being replicated.</p>
752
 
<dl class="params"><dt>Parameters</dt><dd>
753
 
  <table class="params">
754
 
    <tr><td class="paramname">obj</td><td>the object to set properties on </td></tr>
755
 
    <tr><td class="paramname">flags</td><td>Flags for behaviour; can be MAPI_PROPS_SKIP_NAMEDID_CHECK </td></tr>
756
 
    <tr><td class="paramname">lpProps</td><td>the list of properties to set </td></tr>
757
 
    <tr><td class="paramname">PropCount</td><td>the number of properties</td></tr>
758
 
  </table>
759
 
  </dd>
760
 
</dl>
761
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
762
 
<dl class="section note"><dt>Note</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>
763
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
764
 
<li>MAPI_E_INVALID_PARAMETER: obj is not valid</li>
765
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
766
 
</ul>
767
 
</dd></dl>
768
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#a493019f7bf3431d246b1e3a6b3114084">SetProps</a>, <a class="el" href="IMAPIProp_8c.html#a729ca053b8f7a3bd7c6a299559c26053">DeletePropertiesNoReplicate</a> </dd></dl>
769
 
 
770
 
<p>References <a class="el" href="property_8c.html#a70f67e9d21b97a881b56f3b44b2dd282">cast_mapi_SPropValue()</a>, <a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a>, <a class="el" href="mapi__nameid_8c.html#a9d9381cc7e02705c8e638ada27d6ad57">mapi_nameid_lookup_SPropValue()</a>, <a class="el" href="mapi__nameid_8c.html#a6d5e2f646b696da66afcdf6632c293bf">mapi_nameid_map_SPropValue()</a>, <a class="el" href="mapi__nameid_8c.html#a7705209e3f79f856778b900123159f80">mapi_nameid_new()</a>, <a class="el" href="mapi__nameid_8c.html#a9429aa3e7cbb75a388fc5b1fc03cbec8">mapi_nameid_unmap_SPropValue()</a>, <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>, and <a class="el" href="IUnknown_8c.html#a52246b3bbc755db550d9d13e772dd479">MAPIFreeBuffer()</a>.</p>
771
 
 
772
 
</div>
773
 
</div>
774
 
<a class="anchor" id="a493019f7bf3431d246b1e3a6b3114084"></a>
775
 
<div class="memitem">
776
 
<div class="memproto">
777
 
      <table class="memname">
778
 
        <tr>
779
 
          <td class="memname">_PUBLIC_ enum MAPISTATUS SetProps </td>
780
 
          <td>(</td>
781
 
          <td class="paramtype">mapi_object_t *&#160;</td>
782
 
          <td class="paramname"><em>obj</em>, </td>
783
 
        </tr>
784
 
        <tr>
785
 
          <td class="paramkey"></td>
786
 
          <td></td>
787
 
          <td class="paramtype">uint32_t&#160;</td>
788
 
          <td class="paramname"><em>flags</em>, </td>
789
 
        </tr>
790
 
        <tr>
791
 
          <td class="paramkey"></td>
792
 
          <td></td>
793
 
          <td class="paramtype">struct SPropValue *&#160;</td>
794
 
          <td class="paramname"><em>lpProps</em>, </td>
795
 
        </tr>
796
 
        <tr>
797
 
          <td class="paramkey"></td>
798
 
          <td></td>
799
 
          <td class="paramtype">unsigned long&#160;</td>
800
 
          <td class="paramname"><em>PropCount</em>&#160;</td>
801
 
        </tr>
802
 
        <tr>
803
 
          <td></td>
804
 
          <td>)</td>
805
 
          <td></td><td></td>
806
 
        </tr>
807
 
      </table>
808
 
</div><div class="memdoc">
809
 
<p>Set one or more properties on a given object</p>
810
 
<p>This function sets one or more properties on a specified object.</p>
811
 
<dl class="params"><dt>Parameters</dt><dd>
812
 
  <table class="params">
813
 
    <tr><td class="paramname">obj</td><td>the object to set properties on </td></tr>
814
 
    <tr><td class="paramname">flags</td><td>Flags for behaviour; can be MAPI_PROPS_SKIP_NAMEDID_CHECK </td></tr>
815
 
    <tr><td class="paramname">lpProps</td><td>the list of properties to set </td></tr>
816
 
    <tr><td class="paramname">PropCount</td><td>the number of properties</td></tr>
817
 
  </table>
818
 
  </dd>
819
 
</dl>
820
 
<dl class="section return"><dt>Returns</dt><dd>MAPI_E_SUCCESS on success, otherwise MAPI error.</dd></dl>
821
 
<dl class="section note"><dt>Note</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>
822
 
<li>MAPI_E_NOT_INITIALIZED: MAPI subsystem has not been initialized</li>
823
 
<li>MAPI_E_CALL_FAILED: A network problem was encountered during the transaction</li>
824
 
</ul>
825
 
</dd></dl>
826
 
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="IMAPIProp_8c.html#ade217ac8248ec52af71705ae8df35d47">GetProps</a>, <a class="el" href="IMAPIProp_8c.html#a20913af3ef18646635530f5bd8021061">GetPropList</a>, <a class="el" href="IMAPIProp_8c.html#afbe1c87d25b06d68a23d14443645f1b1">GetPropsAll</a>, <a class="el" href="IMAPIProp_8c.html#ad7c939f4d2da811a8913e6563c9c98f3">DeleteProps</a>, <a class="el" href="IUnknown_8c.html#a8237c7fc76377cb07f3f55920d6f20de">GetLastError</a> </dd></dl>
827
 
 
828
 
<p>References <a class="el" href="property_8c.html#a70f67e9d21b97a881b56f3b44b2dd282">cast_mapi_SPropValue()</a>, <a class="el" href="IMAPIProp_8c.html#ac7a673fa38d4f737c5b1f8fa905f8155">GetIDsFromNames()</a>, <a class="el" href="mapi__nameid_8c.html#a9d9381cc7e02705c8e638ada27d6ad57">mapi_nameid_lookup_SPropValue()</a>, <a class="el" href="mapi__nameid_8c.html#a6d5e2f646b696da66afcdf6632c293bf">mapi_nameid_map_SPropValue()</a>, <a class="el" href="mapi__nameid_8c.html#a7705209e3f79f856778b900123159f80">mapi_nameid_new()</a>, <a class="el" href="mapi__nameid_8c.html#a9429aa3e7cbb75a388fc5b1fc03cbec8">mapi_nameid_unmap_SPropValue()</a>, <a class="el" href="mapi__object_8c.html#aa94645f34e6c4bf1c0631dffb0742676">mapi_object_get_handle()</a>, <a class="el" href="mapi__object_8c.html#a96bfa7545b6e9ad350c42ba0abd07da8">mapi_object_get_logon_id()</a>, <a class="el" href="mapi__object_8c.html#ae5ef3137838fbc0c3eaedd7da99f8adc">mapi_object_get_session()</a>, and <a class="el" href="IUnknown_8c.html#a52246b3bbc755db550d9d13e772dd479">MAPIFreeBuffer()</a>.</p>
829
 
 
830
 
</div>
831
 
</div>
832
 
</div><!-- contents -->
833
 
</div>
834
 
<br/>
835
 
<table style="clear:both; margin: 0.5em auto; width:80%; text-align: center; background-color:#f8f8f8; border:2px solid #e0e0e0; padding:5px;">
836
 
<tr>
837
 
<td> 
838
 
  <img alt="Creative Commons License" src="CC_SomeRightsReserved.png" width="90" height="30" border="0" /><br />
839
 
  <img alt="Creative Commons Attribution icon" src="24px-Cc-by_white.svg.png" width="24" height="24" border="0" />
840
 
  <img alt="Creative Commons Share Alike icon" src="24px-Cc-sa_white.svg.png" width="24" height="24" border="0" />
841
 
</td>
842
 
<td> <i><strong class="selflink">This content</strong> is licensed under the Creative Commons<br />
843
 
Attribution ShareAlike License v. 3.0:<br />
844
 
<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>
845
 
</td></tr></table>
846
 
<br/>
847
 
</div>
848
 
</div>
849
 
</body>
850
 
</html>