/usr/share/proton-0.14.0/docs/api-c/message_8h_source.html is in libqpid-proton8-dev-doc 0.14.0-5.1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>proton: /build/qpid-proton-4llz2H/qpid-proton-0.14.0/proton-c/include/proton/message.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">proton
 <span id="projectnumber">0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_3d7fee5163f29235853f3037db69c226.html">proton-c</a></li><li class="navelem"><a class="el" href="dir_ca4610195e991eb8124aba7312da0967.html">include</a></li><li class="navelem"><a class="el" href="dir_819e9c3ec552076ba9984156db77a62b.html">proton</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">message.h</div> </div>
</div><!--header-->
<div class="contents">
<a href="message_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="preprocessor">#ifndef PROTON_MESSAGE_H</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="preprocessor">#define PROTON_MESSAGE_H 1</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> </div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">/*</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"> *</span></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"> * Licensed to the Apache Software Foundation (ASF) under one</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment"> * or more contributor license agreements. See the NOTICE file</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> * distributed with this work for additional information</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment"> * regarding copyright ownership. The ASF licenses this file</span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"> * to you under the Apache License, Version 2.0 (the</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment"> * "License"); you may not use this file except in compliance</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"> * with the License. You may obtain a copy of the License at</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"> *</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> * http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment"> *</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"> * Unless required by applicable law or agreed to in writing,</span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> * software distributed under the License is distributed on an</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> * KIND, either express or implied. See the License for the</span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment"> * specific language governing permissions and limitations</span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment"> * under the License.</span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment"> *</span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment"> */</span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> </div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="preprocessor">#include <<a class="code" href="import__export_8h.html">proton/import_export.h</a>></span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <<a class="code" href="types_8h.html">proton/types.h</a>></span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include <<a class="code" href="codec_8h.html">proton/codec.h</a>></span></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <<a class="code" href="error_8h.html">proton/error.h</a>></span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="type__compat_8h.html">proton/type_compat.h</a>></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> </div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#ifdef __cplusplus</span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="keyword">extern</span> <span class="stringliteral">"C"</span> {</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="comment"></span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment">/** @file</span></div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="comment"> * Message API for encoding/decoding AMQP Messages.</span></div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment"> *</span></div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment"> * @defgroup message Message</span></div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment"> * @{</span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment"> */</span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment"></span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">/**</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment"> * An AMQP Message object.</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment"> *</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment"> * An AMQP Message object is a mutable holder of message content that</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment"> * may be used to generate and encode or decode and access AMQP</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment"> * formatted message data.</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment"> */</span></div><div class="line"><a name="l00049"></a><span class="lineno"><a class="line" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2"> 49</a></span> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> <a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a>;</div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment"></span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">/**</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment"> * Default priority for messages.</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment"> */</span></div><div class="line"><a name="l00054"></a><span class="lineno"><a class="line" href="group__message.html#ga732b155202644a5c5be75a651a3c4fac"> 54</a></span> <span class="preprocessor">#define PN_DEFAULT_PRIORITY (4)</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment"></span></div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">/**</span></div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment"> * Construct a new ::pn_message_t.</span></div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment"> *</span></div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment"> * Every message that is constructed must be freed using</span></div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="comment"> * ::pn_message_free().</span></div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment"> *</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment"> * @return pointer to a new ::pn_message_t</span></div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment"> */</span></div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> * <a class="code" href="group__message.html#ga29b1ebb0e3d0f4663e679eb92b5dfdb9">pn_message</a>(<span class="keywordtype">void</span>);</div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="comment"></span></div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="comment">/**</span></div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="comment"> * Free a previously constructed ::pn_message_t.</span></div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="comment"> *</span></div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="comment"> * @param[in] msg pointer to a ::pn_message_t or NULL</span></div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment"> */</span></div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">void</span> <a class="code" href="group__message.html#ga02854827986ba1b0e36d0005674661c4">pn_message_free</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment"></span></div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment">/**</span></div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="comment"> * Clears the content of a ::pn_message_t.</span></div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="comment"> *</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="comment"> * When pn_message_clear returns, the supplied ::pn_message_t will be</span></div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment"> * emptied of all content and effectively returned to the same state</span></div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment"> * as if it was just created.</span></div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="comment"> *</span></div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="comment"> * @param[in] msg pointer to the ::pn_message_t to be cleared</span></div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="comment"> */</span></div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">void</span> <a class="code" href="group__message.html#gad82108b69076e73f9a413297eb0fe93a">pn_message_clear</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="comment"></span></div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="comment">/**</span></div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="comment"> * Access the error code of a message.</span></div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span> <span class="comment"> *</span></div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="comment"> * Every operation on a message that can result in an error will set</span></div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="comment"> * the message's error code in case of error. The pn_message_errno()</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="comment"> * call will access the error code of the most recent failed</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span> <span class="comment"> * operation.</span></div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span> <span class="comment"> *</span></div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span> <span class="comment"> * @param[in] msg a message</span></div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span> <span class="comment"> * @return the message's error code</span></div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="comment"> */</span></div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga98c45926c58fabb1465c59d9aa4056ff">pn_message_errno</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span> <span class="comment"></span></div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <span class="comment">/**</span></div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span> <span class="comment"> * Access the error information for a message.</span></div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span> <span class="comment"> *</span></div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span> <span class="comment"> * Every operation on a message that can result in an error will</span></div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span> <span class="comment"> * update the error information held by its error descriptor should</span></div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span> <span class="comment"> * that operation fail. The pn_message_error() call will access the</span></div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span> <span class="comment"> * error information of the most recent failed operation. The pointer</span></div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span> <span class="comment"> * returned by this call is valid until the message is freed.</span></div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="comment"> *</span></div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="comment"> * @param[in] msg a message</span></div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="comment"> * @return the message's error descriptor</span></div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="comment"> */</span></div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="error_8h.html#a24a289d5b32c9bd8a775600a5af83d52">pn_error_t</a> *<a class="code" href="group__message.html#ga87bacde8d1733671663832dbb9fd097c">pn_message_error</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="comment"></span></div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="comment">/**</span></div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="comment"> * Get the inferred flag for a message.</span></div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="comment"> *</span></div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment"> * The inferred flag for a message indicates how the message content</span></div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment"> * is encoded into AMQP sections. If inferred is true then binary and</span></div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment"> * list values in the body of the message will be encoded as AMQP DATA</span></div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="comment"> * and AMQP SEQUENCE sections, respectively. If inferred is false,</span></div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment"> * then all values in the body of the message will be encoded as AMQP</span></div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment"> * VALUE sections regardless of their type. Use</span></div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="comment"> * ::pn_message_set_inferred to set the value.</span></div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment"> *</span></div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span> <span class="comment"> * @return the value of the inferred flag for the message</span></div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="comment"> */</span></div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">bool</span> <a class="code" href="group__message.html#ga19e41e8cfac95c2cd0f77a92c4ec85eb">pn_message_is_inferred</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment"></span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="comment">/**</span></div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span> <span class="comment"> * Set the inferred flag for a message.</span></div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="comment"> *</span></div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span> <span class="comment"> * See ::pn_message_is_inferred() for a description of what the</span></div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <span class="comment"> * inferred flag is.</span></div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment"> *</span></div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span> <span class="comment"> * @param[in] inferred the new value of the inferred flag</span></div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="comment"> */</span></div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#gaa0a2a7abe7f484b5f4d5d7168d082c8e">pn_message_set_inferred</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keywordtype">bool</span> inferred);</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span> </div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span> <span class="comment">// standard message headers and properties</span></div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span> <span class="comment"></span></div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="comment">/**</span></div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span> <span class="comment"> * Get the durable flag for a message.</span></div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span> <span class="comment"> *</span></div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span> <span class="comment"> * The durable flag indicates that any parties taking responsibility</span></div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="comment"> * for the message must durably store the content.</span></div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="comment"> *</span></div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment"> * @return the value of the durable flag</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="comment"> */</span></div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">bool</span> <a class="code" href="group__message.html#ga0639e7686a2fdaabec64e26675fa805a">pn_message_is_durable</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="comment"></span></div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="comment">/**</span></div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <span class="comment"> * Set the durable flag for a message.</span></div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span> <span class="comment"> *</span></div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span> <span class="comment"> * See ::pn_message_is_durable() for a description of the durable</span></div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="comment"> * flag.</span></div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span> <span class="comment"> *</span></div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span> <span class="comment"> * @param[in] durable the new value of the durable flag</span></div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span> <span class="comment"> */</span></div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga29d5812830f4379461472761cd5e056b">pn_message_set_durable</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keywordtype">bool</span> durable);</div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span> <span class="comment"></span></div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span> <span class="comment">/**</span></div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span> <span class="comment"> * Get the priority for a message.</span></div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span> <span class="comment"> *</span></div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span> <span class="comment"> * The priority of a message impacts ordering guarantees. Within a</span></div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span> <span class="comment"> * given ordered context, higher priority messages may jump ahead of</span></div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span> <span class="comment"> * lower priority messages.</span></div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span> <span class="comment"> *</span></div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span> <span class="comment"> * @return the message priority</span></div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span> <span class="comment"> */</span></div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> uint8_t <a class="code" href="group__message.html#gaf0df7d607fb85c78ada340df52db745c">pn_message_get_priority</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="comment"></span></div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span> <span class="comment">/**</span></div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="comment"> * Set the priority for a message.</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment"> *</span></div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span> <span class="comment"> * See ::pn_message_get_priority() for details on message priority.</span></div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="comment"> *</span></div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span> <span class="comment"> * @param[in] priority the new priority for the message</span></div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="comment"> */</span></div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga5878b877a0b119f9eb6a7a02bdda6358">pn_message_set_priority</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, uint8_t priority);</div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span> <span class="comment"></span></div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span> <span class="comment">/**</span></div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span> <span class="comment"> * Get the ttl for a message.</span></div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="comment"> *</span></div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span> <span class="comment"> * The ttl for a message determines how long a message is considered</span></div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span> <span class="comment"> * live. When a message is held for retransmit, the ttl is</span></div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span> <span class="comment"> * decremented. Once the ttl reaches zero, the message is considered</span></div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span> <span class="comment"> * dead. Once a message is considered dead it may be dropped. Use</span></div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span> <span class="comment"> * ::pn_message_set_ttl() to set the ttl for a message.</span></div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span> <span class="comment"> *</span></div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span> <span class="comment"> * @return the ttl in milliseconds</span></div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span> <span class="comment"> */</span></div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__primitives.html#ga9a701bc6dc9af9f42c3f4679172a723c">pn_millis_t</a> <a class="code" href="group__message.html#ga9bc059be1b3f8b48e3e02d03bd0e31cf">pn_message_get_ttl</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span> <span class="comment"></span></div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="comment">/**</span></div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span> <span class="comment"> * Set the ttl for a message.</span></div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span> <span class="comment"> *</span></div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment"> * See ::pn_message_get_ttl() for a detailed description of message ttl.</span></div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span> <span class="comment"> *</span></div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span> <span class="comment"> * @param[in] ttl the new value for the message ttl</span></div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span> <span class="comment"> */</span></div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga231109a27ed77c5440f5fd5e8e271dc3">pn_message_set_ttl</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <a class="code" href="group__primitives.html#ga9a701bc6dc9af9f42c3f4679172a723c">pn_millis_t</a> ttl);</div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span> <span class="comment"></span></div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span> <span class="comment">/**</span></div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span> <span class="comment"> * Get the first acquirer flag for a message.</span></div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span> <span class="comment"> *</span></div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span> <span class="comment"> * When set to true, the first acquirer flag for a message indicates</span></div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span> <span class="comment"> * that the recipient of the message is the first recipient to acquire</span></div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span> <span class="comment"> * the message, i.e. there have been no failed delivery attempts to</span></div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span> <span class="comment"> * other acquirers. Note that this does not mean the message has not</span></div><div class="line"><a name="l00219"></a><span class="lineno"> 219</span> <span class="comment"> * been delivered to, but not acquired, by other recipients.</span></div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span> <span class="comment"> *</span></div><div class="line"><a name="l00221"></a><span class="lineno"> 221</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span> <span class="comment"> * @return the first acquirer flag for the message</span></div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span> <span class="comment"> */</span></div><div class="line"><a name="l00224"></a><span class="lineno"> 224</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">bool</span> <a class="code" href="group__message.html#ga147807825163b84d9fdd7556fad42608">pn_message_is_first_acquirer</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00225"></a><span class="lineno"> 225</span> <span class="comment"></span></div><div class="line"><a name="l00226"></a><span class="lineno"> 226</span> <span class="comment">/**</span></div><div class="line"><a name="l00227"></a><span class="lineno"> 227</span> <span class="comment"> * Set the first acquirer flag for a message.</span></div><div class="line"><a name="l00228"></a><span class="lineno"> 228</span> <span class="comment"> *</span></div><div class="line"><a name="l00229"></a><span class="lineno"> 229</span> <span class="comment"> * See ::pn_message_is_first_acquirer() for details on the first</span></div><div class="line"><a name="l00230"></a><span class="lineno"> 230</span> <span class="comment"> * acquirer flag.</span></div><div class="line"><a name="l00231"></a><span class="lineno"> 231</span> <span class="comment"> *</span></div><div class="line"><a name="l00232"></a><span class="lineno"> 232</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00233"></a><span class="lineno"> 233</span> <span class="comment"> * @param[in] first the new value for the first acquirer flag</span></div><div class="line"><a name="l00234"></a><span class="lineno"> 234</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00235"></a><span class="lineno"> 235</span> <span class="comment"> */</span></div><div class="line"><a name="l00236"></a><span class="lineno"> 236</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga00b7a4b62de07b070191398e1f1cff02">pn_message_set_first_acquirer</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keywordtype">bool</span> first);</div><div class="line"><a name="l00237"></a><span class="lineno"> 237</span> <span class="comment"></span></div><div class="line"><a name="l00238"></a><span class="lineno"> 238</span> <span class="comment">/**</span></div><div class="line"><a name="l00239"></a><span class="lineno"> 239</span> <span class="comment"> * Get the delivery count for a message.</span></div><div class="line"><a name="l00240"></a><span class="lineno"> 240</span> <span class="comment"> *</span></div><div class="line"><a name="l00241"></a><span class="lineno"> 241</span> <span class="comment"> * The delivery count field tracks how many attempts have been made to</span></div><div class="line"><a name="l00242"></a><span class="lineno"> 242</span> <span class="comment"> * delivery a message. Use ::pn_message_set_delivery_count() to set</span></div><div class="line"><a name="l00243"></a><span class="lineno"> 243</span> <span class="comment"> * the delivery count for a message.</span></div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span> <span class="comment"> *</span></div><div class="line"><a name="l00245"></a><span class="lineno"> 245</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00246"></a><span class="lineno"> 246</span> <span class="comment"> * @return the delivery count for the message</span></div><div class="line"><a name="l00247"></a><span class="lineno"> 247</span> <span class="comment"> */</span></div><div class="line"><a name="l00248"></a><span class="lineno"> 248</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> uint32_t <a class="code" href="group__message.html#gae6061ca4cd91f35db285ad4e736b4880">pn_message_get_delivery_count</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00249"></a><span class="lineno"> 249</span> <span class="comment"></span></div><div class="line"><a name="l00250"></a><span class="lineno"> 250</span> <span class="comment">/**</span></div><div class="line"><a name="l00251"></a><span class="lineno"> 251</span> <span class="comment"> * Set the delivery count for a message.</span></div><div class="line"><a name="l00252"></a><span class="lineno"> 252</span> <span class="comment"> *</span></div><div class="line"><a name="l00253"></a><span class="lineno"> 253</span> <span class="comment"> * See ::pn_message_get_delivery_count() for details on what the</span></div><div class="line"><a name="l00254"></a><span class="lineno"> 254</span> <span class="comment"> * delivery count means.</span></div><div class="line"><a name="l00255"></a><span class="lineno"> 255</span> <span class="comment"> *</span></div><div class="line"><a name="l00256"></a><span class="lineno"> 256</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00257"></a><span class="lineno"> 257</span> <span class="comment"> * @param[in] count the new delivery count</span></div><div class="line"><a name="l00258"></a><span class="lineno"> 258</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00259"></a><span class="lineno"> 259</span> <span class="comment"> */</span></div><div class="line"><a name="l00260"></a><span class="lineno"> 260</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga9e29a74bbaf88a38d488df17940f637a">pn_message_set_delivery_count</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, uint32_t count);</div><div class="line"><a name="l00261"></a><span class="lineno"> 261</span> <span class="comment"></span></div><div class="line"><a name="l00262"></a><span class="lineno"> 262</span> <span class="comment">/**</span></div><div class="line"><a name="l00263"></a><span class="lineno"> 263</span> <span class="comment"> * Get/set the id for a message.</span></div><div class="line"><a name="l00264"></a><span class="lineno"> 264</span> <span class="comment"> *</span></div><div class="line"><a name="l00265"></a><span class="lineno"> 265</span> <span class="comment"> * The message id provides a globally unique identifier for a message.</span></div><div class="line"><a name="l00266"></a><span class="lineno"> 266</span> <span class="comment"> * A message id can be an a string, an unsigned long, a uuid or a</span></div><div class="line"><a name="l00267"></a><span class="lineno"> 267</span> <span class="comment"> * binary value. This operation returns a pointer to a ::pn_data_t</span></div><div class="line"><a name="l00268"></a><span class="lineno"> 268</span> <span class="comment"> * that can be used to access and/or modify the value of the message</span></div><div class="line"><a name="l00269"></a><span class="lineno"> 269</span> <span class="comment"> * id. The pointer is valid until the message is freed. See</span></div><div class="line"><a name="l00270"></a><span class="lineno"> 270</span> <span class="comment"> * ::pn_data_t for details on how to get/set the value.</span></div><div class="line"><a name="l00271"></a><span class="lineno"> 271</span> <span class="comment"> *</span></div><div class="line"><a name="l00272"></a><span class="lineno"> 272</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00273"></a><span class="lineno"> 273</span> <span class="comment"> * @return pointer to a ::pn_data_t holding the id</span></div><div class="line"><a name="l00274"></a><span class="lineno"> 274</span> <span class="comment"> */</span></div><div class="line"><a name="l00275"></a><span class="lineno"> 275</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__data.html#ga5d6cf528776e8b6ad6d67caf095986bf">pn_data_t</a> * <a class="code" href="group__message.html#gad63613b52062ab477ac9c32f7131cda4">pn_message_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00276"></a><span class="lineno"> 276</span> <span class="comment"></span></div><div class="line"><a name="l00277"></a><span class="lineno"> 277</span> <span class="comment">/**</span></div><div class="line"><a name="l00278"></a><span class="lineno"> 278</span> <span class="comment"> * Get the id for a message.</span></div><div class="line"><a name="l00279"></a><span class="lineno"> 279</span> <span class="comment"> *</span></div><div class="line"><a name="l00280"></a><span class="lineno"> 280</span> <span class="comment"> * The message id provides a globally unique identifier for a message.</span></div><div class="line"><a name="l00281"></a><span class="lineno"> 281</span> <span class="comment"> * A message id can be an a string, an unsigned long, a uuid or a</span></div><div class="line"><a name="l00282"></a><span class="lineno"> 282</span> <span class="comment"> * binary value. This operation returns the value of the id using the</span></div><div class="line"><a name="l00283"></a><span class="lineno"> 283</span> <span class="comment"> * ::pn_atom_t descriminated union. See ::pn_atom_t for details on how</span></div><div class="line"><a name="l00284"></a><span class="lineno"> 284</span> <span class="comment"> * to access the value.</span></div><div class="line"><a name="l00285"></a><span class="lineno"> 285</span> <span class="comment"> *</span></div><div class="line"><a name="l00286"></a><span class="lineno"> 286</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00287"></a><span class="lineno"> 287</span> <span class="comment"> * @return the message id</span></div><div class="line"><a name="l00288"></a><span class="lineno"> 288</span> <span class="comment"> */</span></div><div class="line"><a name="l00289"></a><span class="lineno"> 289</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="structpn__atom__t.html">pn_atom_t</a> <a class="code" href="group__message.html#ga6dc34192b0b265792e80b909733fc446">pn_message_get_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00290"></a><span class="lineno"> 290</span> <span class="comment"></span></div><div class="line"><a name="l00291"></a><span class="lineno"> 291</span> <span class="comment">/**</span></div><div class="line"><a name="l00292"></a><span class="lineno"> 292</span> <span class="comment"> * Set the id for a message.</span></div><div class="line"><a name="l00293"></a><span class="lineno"> 293</span> <span class="comment"> *</span></div><div class="line"><a name="l00294"></a><span class="lineno"> 294</span> <span class="comment"> * See ::pn_message_get_id() for more details on the meaning of the</span></div><div class="line"><a name="l00295"></a><span class="lineno"> 295</span> <span class="comment"> * message id. Note that only string, unsigned long, uuid, or binary</span></div><div class="line"><a name="l00296"></a><span class="lineno"> 296</span> <span class="comment"> * values are permitted.</span></div><div class="line"><a name="l00297"></a><span class="lineno"> 297</span> <span class="comment"> *</span></div><div class="line"><a name="l00298"></a><span class="lineno"> 298</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00299"></a><span class="lineno"> 299</span> <span class="comment"> * @param[in] id the new value of the message id</span></div><div class="line"><a name="l00300"></a><span class="lineno"> 300</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00301"></a><span class="lineno"> 301</span> <span class="comment"> */</span></div><div class="line"><a name="l00302"></a><span class="lineno"> 302</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#gaaaa2eb9b3638f556a8e89643e7d5751d">pn_message_set_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <a class="code" href="structpn__atom__t.html">pn_atom_t</a> <span class="keywordtype">id</span>);</div><div class="line"><a name="l00303"></a><span class="lineno"> 303</span> <span class="comment"></span></div><div class="line"><a name="l00304"></a><span class="lineno"> 304</span> <span class="comment">/**</span></div><div class="line"><a name="l00305"></a><span class="lineno"> 305</span> <span class="comment"> * Get the user id for a message.</span></div><div class="line"><a name="l00306"></a><span class="lineno"> 306</span> <span class="comment"> *</span></div><div class="line"><a name="l00307"></a><span class="lineno"> 307</span> <span class="comment"> * The pointer referenced by the ::pn_bytes_t struct will be valid</span></div><div class="line"><a name="l00308"></a><span class="lineno"> 308</span> <span class="comment"> * until any one of the following operations occur:</span></div><div class="line"><a name="l00309"></a><span class="lineno"> 309</span> <span class="comment"> *</span></div><div class="line"><a name="l00310"></a><span class="lineno"> 310</span> <span class="comment"> * - ::pn_message_free()</span></div><div class="line"><a name="l00311"></a><span class="lineno"> 311</span> <span class="comment"> * - ::pn_message_clear()</span></div><div class="line"><a name="l00312"></a><span class="lineno"> 312</span> <span class="comment"> * - ::pn_message_set_user_id()</span></div><div class="line"><a name="l00313"></a><span class="lineno"> 313</span> <span class="comment"> *</span></div><div class="line"><a name="l00314"></a><span class="lineno"> 314</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00315"></a><span class="lineno"> 315</span> <span class="comment"> * @return a pn_bytes_t referencing the message's user_id</span></div><div class="line"><a name="l00316"></a><span class="lineno"> 316</span> <span class="comment"> */</span></div><div class="line"><a name="l00317"></a><span class="lineno"> 317</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="structpn__bytes__t.html">pn_bytes_t</a> <a class="code" href="group__message.html#gab420ee7f0d06a3771e27b3bc0d97ded2">pn_message_get_user_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00318"></a><span class="lineno"> 318</span> <span class="comment"></span></div><div class="line"><a name="l00319"></a><span class="lineno"> 319</span> <span class="comment">/**</span></div><div class="line"><a name="l00320"></a><span class="lineno"> 320</span> <span class="comment"> * Set the user id for a message.</span></div><div class="line"><a name="l00321"></a><span class="lineno"> 321</span> <span class="comment"> *</span></div><div class="line"><a name="l00322"></a><span class="lineno"> 322</span> <span class="comment"> * This operation copies the bytes referenced by the provided</span></div><div class="line"><a name="l00323"></a><span class="lineno"> 323</span> <span class="comment"> * ::pn_bytes_t struct.</span></div><div class="line"><a name="l00324"></a><span class="lineno"> 324</span> <span class="comment"> *</span></div><div class="line"><a name="l00325"></a><span class="lineno"> 325</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00326"></a><span class="lineno"> 326</span> <span class="comment"> * @param[in] user_id the new user_id for the message</span></div><div class="line"><a name="l00327"></a><span class="lineno"> 327</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00328"></a><span class="lineno"> 328</span> <span class="comment"> */</span></div><div class="line"><a name="l00329"></a><span class="lineno"> 329</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#gab10575fed8437d431da449e04f835f6d">pn_message_set_user_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <a class="code" href="structpn__bytes__t.html">pn_bytes_t</a> user_id);</div><div class="line"><a name="l00330"></a><span class="lineno"> 330</span> <span class="comment"></span></div><div class="line"><a name="l00331"></a><span class="lineno"> 331</span> <span class="comment">/**</span></div><div class="line"><a name="l00332"></a><span class="lineno"> 332</span> <span class="comment"> * Get the address for a message.</span></div><div class="line"><a name="l00333"></a><span class="lineno"> 333</span> <span class="comment"> *</span></div><div class="line"><a name="l00334"></a><span class="lineno"> 334</span> <span class="comment"> * This operation will return NULL if no address has been set or if</span></div><div class="line"><a name="l00335"></a><span class="lineno"> 335</span> <span class="comment"> * the address has been set to NULL. The pointer returned by this</span></div><div class="line"><a name="l00336"></a><span class="lineno"> 336</span> <span class="comment"> * operation is valid until any one of the following operations occur:</span></div><div class="line"><a name="l00337"></a><span class="lineno"> 337</span> <span class="comment"> *</span></div><div class="line"><a name="l00338"></a><span class="lineno"> 338</span> <span class="comment"> * - ::pn_message_free()</span></div><div class="line"><a name="l00339"></a><span class="lineno"> 339</span> <span class="comment"> * - ::pn_message_clear()</span></div><div class="line"><a name="l00340"></a><span class="lineno"> 340</span> <span class="comment"> * - ::pn_message_set_address()</span></div><div class="line"><a name="l00341"></a><span class="lineno"> 341</span> <span class="comment"> *</span></div><div class="line"><a name="l00342"></a><span class="lineno"> 342</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00343"></a><span class="lineno"> 343</span> <span class="comment"> * @return a pointer to the address of the message (or NULL)</span></div><div class="line"><a name="l00344"></a><span class="lineno"> 344</span> <span class="comment"> */</span></div><div class="line"><a name="l00345"></a><span class="lineno"> 345</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keyword">const</span> <span class="keywordtype">char</span> * <a class="code" href="group__message.html#ga8cb345cb31c3a3349688799b6b4f2006">pn_message_get_address</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00346"></a><span class="lineno"> 346</span> <span class="comment"></span></div><div class="line"><a name="l00347"></a><span class="lineno"> 347</span> <span class="comment">/**</span></div><div class="line"><a name="l00348"></a><span class="lineno"> 348</span> <span class="comment"> * Set the address for a message.</span></div><div class="line"><a name="l00349"></a><span class="lineno"> 349</span> <span class="comment"> *</span></div><div class="line"><a name="l00350"></a><span class="lineno"> 350</span> <span class="comment"> * The supplied address pointer must either be NULL or reference a NUL</span></div><div class="line"><a name="l00351"></a><span class="lineno"> 351</span> <span class="comment"> * terminated string. When the pointer is NULL, the address of the</span></div><div class="line"><a name="l00352"></a><span class="lineno"> 352</span> <span class="comment"> * message is set to NULL. When the pointer is non NULL, the contents</span></div><div class="line"><a name="l00353"></a><span class="lineno"> 353</span> <span class="comment"> * are copied into the message.</span></div><div class="line"><a name="l00354"></a><span class="lineno"> 354</span> <span class="comment"> *</span></div><div class="line"><a name="l00355"></a><span class="lineno"> 355</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00356"></a><span class="lineno"> 356</span> <span class="comment"> * @param[in] address a pointer to the new address (or NULL)</span></div><div class="line"><a name="l00357"></a><span class="lineno"> 357</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00358"></a><span class="lineno"> 358</span> <span class="comment"> */</span></div><div class="line"><a name="l00359"></a><span class="lineno"> 359</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#gadae5d992568a088c561e5ddcdde13705">pn_message_set_address</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keyword">const</span> <span class="keywordtype">char</span> *address);</div><div class="line"><a name="l00360"></a><span class="lineno"> 360</span> <span class="comment"></span></div><div class="line"><a name="l00361"></a><span class="lineno"> 361</span> <span class="comment">/**</span></div><div class="line"><a name="l00362"></a><span class="lineno"> 362</span> <span class="comment"> * Get the subject for a message.</span></div><div class="line"><a name="l00363"></a><span class="lineno"> 363</span> <span class="comment"> *</span></div><div class="line"><a name="l00364"></a><span class="lineno"> 364</span> <span class="comment"> * This operation will return NULL if no subject has been set or if</span></div><div class="line"><a name="l00365"></a><span class="lineno"> 365</span> <span class="comment"> * the subject has been set to NULL. The pointer returned by this</span></div><div class="line"><a name="l00366"></a><span class="lineno"> 366</span> <span class="comment"> * operation is valid until any one of the following operations occur:</span></div><div class="line"><a name="l00367"></a><span class="lineno"> 367</span> <span class="comment"> *</span></div><div class="line"><a name="l00368"></a><span class="lineno"> 368</span> <span class="comment"> * - ::pn_message_free()</span></div><div class="line"><a name="l00369"></a><span class="lineno"> 369</span> <span class="comment"> * - ::pn_message_clear()</span></div><div class="line"><a name="l00370"></a><span class="lineno"> 370</span> <span class="comment"> * - ::pn_message_set_subject()</span></div><div class="line"><a name="l00371"></a><span class="lineno"> 371</span> <span class="comment"> *</span></div><div class="line"><a name="l00372"></a><span class="lineno"> 372</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00373"></a><span class="lineno"> 373</span> <span class="comment"> * @return a pointer to the subject of the message (or NULL)</span></div><div class="line"><a name="l00374"></a><span class="lineno"> 374</span> <span class="comment"> */</span></div><div class="line"><a name="l00375"></a><span class="lineno"> 375</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keyword">const</span> <span class="keywordtype">char</span> * <a class="code" href="group__message.html#gaf5a583d0cc1ee1a91d02e3f772a25771">pn_message_get_subject</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00376"></a><span class="lineno"> 376</span> <span class="comment"></span></div><div class="line"><a name="l00377"></a><span class="lineno"> 377</span> <span class="comment">/**</span></div><div class="line"><a name="l00378"></a><span class="lineno"> 378</span> <span class="comment"> * Set the subject for a message.</span></div><div class="line"><a name="l00379"></a><span class="lineno"> 379</span> <span class="comment"> *</span></div><div class="line"><a name="l00380"></a><span class="lineno"> 380</span> <span class="comment"> * The supplied subject pointer must either be NULL or reference a NUL</span></div><div class="line"><a name="l00381"></a><span class="lineno"> 381</span> <span class="comment"> * terminated string. When the pointer is NULL, the subject is set to</span></div><div class="line"><a name="l00382"></a><span class="lineno"> 382</span> <span class="comment"> * NULL. When the pointer is non NULL, the contents are copied into</span></div><div class="line"><a name="l00383"></a><span class="lineno"> 383</span> <span class="comment"> * the message.</span></div><div class="line"><a name="l00384"></a><span class="lineno"> 384</span> <span class="comment"> *</span></div><div class="line"><a name="l00385"></a><span class="lineno"> 385</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00386"></a><span class="lineno"> 386</span> <span class="comment"> * @param[in] subject a pointer to the new subject (or NULL)</span></div><div class="line"><a name="l00387"></a><span class="lineno"> 387</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00388"></a><span class="lineno"> 388</span> <span class="comment"> */</span></div><div class="line"><a name="l00389"></a><span class="lineno"> 389</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#gaafc66aca1184747edac543e9a3985a24">pn_message_set_subject</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keyword">const</span> <span class="keywordtype">char</span> *subject);</div><div class="line"><a name="l00390"></a><span class="lineno"> 390</span> <span class="comment"></span></div><div class="line"><a name="l00391"></a><span class="lineno"> 391</span> <span class="comment">/**</span></div><div class="line"><a name="l00392"></a><span class="lineno"> 392</span> <span class="comment"> * Get the reply_to for a message.</span></div><div class="line"><a name="l00393"></a><span class="lineno"> 393</span> <span class="comment"> *</span></div><div class="line"><a name="l00394"></a><span class="lineno"> 394</span> <span class="comment"> * This operation will return NULL if no reply_to has been set or if</span></div><div class="line"><a name="l00395"></a><span class="lineno"> 395</span> <span class="comment"> * the reply_to has been set to NULL. The pointer returned by this</span></div><div class="line"><a name="l00396"></a><span class="lineno"> 396</span> <span class="comment"> * operation is valid until any one of the following operations occur:</span></div><div class="line"><a name="l00397"></a><span class="lineno"> 397</span> <span class="comment"> *</span></div><div class="line"><a name="l00398"></a><span class="lineno"> 398</span> <span class="comment"> * - ::pn_message_free()</span></div><div class="line"><a name="l00399"></a><span class="lineno"> 399</span> <span class="comment"> * - ::pn_message_clear()</span></div><div class="line"><a name="l00400"></a><span class="lineno"> 400</span> <span class="comment"> * - ::pn_message_set_reply_to()</span></div><div class="line"><a name="l00401"></a><span class="lineno"> 401</span> <span class="comment"> *</span></div><div class="line"><a name="l00402"></a><span class="lineno"> 402</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00403"></a><span class="lineno"> 403</span> <span class="comment"> * @return a pointer to the reply_to of the message (or NULL)</span></div><div class="line"><a name="l00404"></a><span class="lineno"> 404</span> <span class="comment"> */</span></div><div class="line"><a name="l00405"></a><span class="lineno"> 405</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keyword">const</span> <span class="keywordtype">char</span> * <a class="code" href="group__message.html#gafe7577a90ec17ff77af79e1b544557d7">pn_message_get_reply_to</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00406"></a><span class="lineno"> 406</span> <span class="comment"></span></div><div class="line"><a name="l00407"></a><span class="lineno"> 407</span> <span class="comment">/**</span></div><div class="line"><a name="l00408"></a><span class="lineno"> 408</span> <span class="comment"> * Set the reply_to for a message.</span></div><div class="line"><a name="l00409"></a><span class="lineno"> 409</span> <span class="comment"> *</span></div><div class="line"><a name="l00410"></a><span class="lineno"> 410</span> <span class="comment"> * The supplied reply_to pointer must either be NULL or reference a NUL</span></div><div class="line"><a name="l00411"></a><span class="lineno"> 411</span> <span class="comment"> * terminated string. When the pointer is NULL, the reply_to is set to</span></div><div class="line"><a name="l00412"></a><span class="lineno"> 412</span> <span class="comment"> * NULL. When the pointer is non NULL, the contents are copied into</span></div><div class="line"><a name="l00413"></a><span class="lineno"> 413</span> <span class="comment"> * the message.</span></div><div class="line"><a name="l00414"></a><span class="lineno"> 414</span> <span class="comment"> *</span></div><div class="line"><a name="l00415"></a><span class="lineno"> 415</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00416"></a><span class="lineno"> 416</span> <span class="comment"> * @param[in] reply_to a pointer to the new reply_to (or NULL)</span></div><div class="line"><a name="l00417"></a><span class="lineno"> 417</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00418"></a><span class="lineno"> 418</span> <span class="comment"> */</span></div><div class="line"><a name="l00419"></a><span class="lineno"> 419</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga04aa890bc4ff9f182462cffd50029123">pn_message_set_reply_to</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keyword">const</span> <span class="keywordtype">char</span> *reply_to);</div><div class="line"><a name="l00420"></a><span class="lineno"> 420</span> <span class="comment"></span></div><div class="line"><a name="l00421"></a><span class="lineno"> 421</span> <span class="comment">/**</span></div><div class="line"><a name="l00422"></a><span class="lineno"> 422</span> <span class="comment"> * Get/set the correlation id for a message.</span></div><div class="line"><a name="l00423"></a><span class="lineno"> 423</span> <span class="comment"> *</span></div><div class="line"><a name="l00424"></a><span class="lineno"> 424</span> <span class="comment"> * A correlation id can be an a string, an unsigned long, a uuid or a</span></div><div class="line"><a name="l00425"></a><span class="lineno"> 425</span> <span class="comment"> * binary value. This operation returns a pointer to a ::pn_data_t</span></div><div class="line"><a name="l00426"></a><span class="lineno"> 426</span> <span class="comment"> * that can be used to access and/or modify the value of the</span></div><div class="line"><a name="l00427"></a><span class="lineno"> 427</span> <span class="comment"> * correlation id. The pointer is valid until the message is freed.</span></div><div class="line"><a name="l00428"></a><span class="lineno"> 428</span> <span class="comment"> * See ::pn_data_t for details on how to get/set the value.</span></div><div class="line"><a name="l00429"></a><span class="lineno"> 429</span> <span class="comment"> *</span></div><div class="line"><a name="l00430"></a><span class="lineno"> 430</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00431"></a><span class="lineno"> 431</span> <span class="comment"> * @return pointer to a ::pn_data_t holding the correlation id</span></div><div class="line"><a name="l00432"></a><span class="lineno"> 432</span> <span class="comment"> */</span></div><div class="line"><a name="l00433"></a><span class="lineno"> 433</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__data.html#ga5d6cf528776e8b6ad6d67caf095986bf">pn_data_t</a> * <a class="code" href="group__message.html#gaa030d35726172445701c3abd365717b3">pn_message_correlation_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00434"></a><span class="lineno"> 434</span> <span class="comment"></span></div><div class="line"><a name="l00435"></a><span class="lineno"> 435</span> <span class="comment">/**</span></div><div class="line"><a name="l00436"></a><span class="lineno"> 436</span> <span class="comment"> * Get the correlation id for a message.</span></div><div class="line"><a name="l00437"></a><span class="lineno"> 437</span> <span class="comment"> *</span></div><div class="line"><a name="l00438"></a><span class="lineno"> 438</span> <span class="comment"> * A correlation id can be an a string, an unsigned long, a uuid or a</span></div><div class="line"><a name="l00439"></a><span class="lineno"> 439</span> <span class="comment"> * binary value. This operation returns the value of the id using the</span></div><div class="line"><a name="l00440"></a><span class="lineno"> 440</span> <span class="comment"> * ::pn_atom_t descriminated union. See ::pn_atom_t for details on how</span></div><div class="line"><a name="l00441"></a><span class="lineno"> 441</span> <span class="comment"> * to access the value.</span></div><div class="line"><a name="l00442"></a><span class="lineno"> 442</span> <span class="comment"> *</span></div><div class="line"><a name="l00443"></a><span class="lineno"> 443</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00444"></a><span class="lineno"> 444</span> <span class="comment"> * @return the message id</span></div><div class="line"><a name="l00445"></a><span class="lineno"> 445</span> <span class="comment"> */</span></div><div class="line"><a name="l00446"></a><span class="lineno"> 446</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="structpn__atom__t.html">pn_atom_t</a> <a class="code" href="group__message.html#ga85500c85e451bb223084a5261be4f107">pn_message_get_correlation_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00447"></a><span class="lineno"> 447</span> <span class="comment"></span></div><div class="line"><a name="l00448"></a><span class="lineno"> 448</span> <span class="comment">/**</span></div><div class="line"><a name="l00449"></a><span class="lineno"> 449</span> <span class="comment"> * Set the correlation id for a message.</span></div><div class="line"><a name="l00450"></a><span class="lineno"> 450</span> <span class="comment"> *</span></div><div class="line"><a name="l00451"></a><span class="lineno"> 451</span> <span class="comment"> * See ::pn_message_get_correlation_id() for more details on the</span></div><div class="line"><a name="l00452"></a><span class="lineno"> 452</span> <span class="comment"> * meaning of the correlation id. Note that only string, unsigned</span></div><div class="line"><a name="l00453"></a><span class="lineno"> 453</span> <span class="comment"> * long, uuid, or binary values are permitted.</span></div><div class="line"><a name="l00454"></a><span class="lineno"> 454</span> <span class="comment"> *</span></div><div class="line"><a name="l00455"></a><span class="lineno"> 455</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00456"></a><span class="lineno"> 456</span> <span class="comment"> * @param[in] id the new value of the message id</span></div><div class="line"><a name="l00457"></a><span class="lineno"> 457</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00458"></a><span class="lineno"> 458</span> <span class="comment"> */</span></div><div class="line"><a name="l00459"></a><span class="lineno"> 459</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#gad8cc824cf918cec1a53816c15527322a">pn_message_set_correlation_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <a class="code" href="structpn__atom__t.html">pn_atom_t</a> <span class="keywordtype">id</span>);</div><div class="line"><a name="l00460"></a><span class="lineno"> 460</span> <span class="comment"></span></div><div class="line"><a name="l00461"></a><span class="lineno"> 461</span> <span class="comment">/**</span></div><div class="line"><a name="l00462"></a><span class="lineno"> 462</span> <span class="comment"> * Get the content_type for a message.</span></div><div class="line"><a name="l00463"></a><span class="lineno"> 463</span> <span class="comment"> *</span></div><div class="line"><a name="l00464"></a><span class="lineno"> 464</span> <span class="comment"> * This operation will return NULL if no content_type has been set or if</span></div><div class="line"><a name="l00465"></a><span class="lineno"> 465</span> <span class="comment"> * the content_type has been set to NULL. The pointer returned by this</span></div><div class="line"><a name="l00466"></a><span class="lineno"> 466</span> <span class="comment"> * operation is valid until any one of the following operations occur:</span></div><div class="line"><a name="l00467"></a><span class="lineno"> 467</span> <span class="comment"> *</span></div><div class="line"><a name="l00468"></a><span class="lineno"> 468</span> <span class="comment"> * - ::pn_message_free()</span></div><div class="line"><a name="l00469"></a><span class="lineno"> 469</span> <span class="comment"> * - ::pn_message_clear()</span></div><div class="line"><a name="l00470"></a><span class="lineno"> 470</span> <span class="comment"> * - ::pn_message_set_content_type()</span></div><div class="line"><a name="l00471"></a><span class="lineno"> 471</span> <span class="comment"> *</span></div><div class="line"><a name="l00472"></a><span class="lineno"> 472</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00473"></a><span class="lineno"> 473</span> <span class="comment"> * @return a pointer to the content_type of the message (or NULL)</span></div><div class="line"><a name="l00474"></a><span class="lineno"> 474</span> <span class="comment"> */</span></div><div class="line"><a name="l00475"></a><span class="lineno"> 475</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keyword">const</span> <span class="keywordtype">char</span> * <a class="code" href="group__message.html#ga8b7dbd80b354c3e1210bd7d223c08d64">pn_message_get_content_type</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00476"></a><span class="lineno"> 476</span> <span class="comment"></span></div><div class="line"><a name="l00477"></a><span class="lineno"> 477</span> <span class="comment">/**</span></div><div class="line"><a name="l00478"></a><span class="lineno"> 478</span> <span class="comment"> * Set the content_type for a message.</span></div><div class="line"><a name="l00479"></a><span class="lineno"> 479</span> <span class="comment"> *</span></div><div class="line"><a name="l00480"></a><span class="lineno"> 480</span> <span class="comment"> * The supplied content_type pointer must either be NULL or reference a NUL</span></div><div class="line"><a name="l00481"></a><span class="lineno"> 481</span> <span class="comment"> * terminated string. When the pointer is NULL, the content_type is set to</span></div><div class="line"><a name="l00482"></a><span class="lineno"> 482</span> <span class="comment"> * NULL. When the pointer is non NULL, the contents are copied into</span></div><div class="line"><a name="l00483"></a><span class="lineno"> 483</span> <span class="comment"> * the message.</span></div><div class="line"><a name="l00484"></a><span class="lineno"> 484</span> <span class="comment"> *</span></div><div class="line"><a name="l00485"></a><span class="lineno"> 485</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00486"></a><span class="lineno"> 486</span> <span class="comment"> * @param[in] type a pointer to the new content_type (or NULL)</span></div><div class="line"><a name="l00487"></a><span class="lineno"> 487</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00488"></a><span class="lineno"> 488</span> <span class="comment"> */</span></div><div class="line"><a name="l00489"></a><span class="lineno"> 489</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga8881958619bd06d75c0c6cfffc59ee07">pn_message_set_content_type</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keyword">const</span> <span class="keywordtype">char</span> *type);</div><div class="line"><a name="l00490"></a><span class="lineno"> 490</span> <span class="comment"></span></div><div class="line"><a name="l00491"></a><span class="lineno"> 491</span> <span class="comment">/**</span></div><div class="line"><a name="l00492"></a><span class="lineno"> 492</span> <span class="comment"> * Get the content_encoding for a message.</span></div><div class="line"><a name="l00493"></a><span class="lineno"> 493</span> <span class="comment"> *</span></div><div class="line"><a name="l00494"></a><span class="lineno"> 494</span> <span class="comment"> * This operation will return NULL if no content_encoding has been set or if</span></div><div class="line"><a name="l00495"></a><span class="lineno"> 495</span> <span class="comment"> * the content_encoding has been set to NULL. The pointer returned by this</span></div><div class="line"><a name="l00496"></a><span class="lineno"> 496</span> <span class="comment"> * operation is valid until any one of the following operations occur:</span></div><div class="line"><a name="l00497"></a><span class="lineno"> 497</span> <span class="comment"> *</span></div><div class="line"><a name="l00498"></a><span class="lineno"> 498</span> <span class="comment"> * - ::pn_message_free()</span></div><div class="line"><a name="l00499"></a><span class="lineno"> 499</span> <span class="comment"> * - ::pn_message_clear()</span></div><div class="line"><a name="l00500"></a><span class="lineno"> 500</span> <span class="comment"> * - ::pn_message_set_content_encoding()</span></div><div class="line"><a name="l00501"></a><span class="lineno"> 501</span> <span class="comment"> *</span></div><div class="line"><a name="l00502"></a><span class="lineno"> 502</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00503"></a><span class="lineno"> 503</span> <span class="comment"> * @return a pointer to the content_encoding of the message (or NULL)</span></div><div class="line"><a name="l00504"></a><span class="lineno"> 504</span> <span class="comment"> */</span></div><div class="line"><a name="l00505"></a><span class="lineno"> 505</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keyword">const</span> <span class="keywordtype">char</span> * <a class="code" href="group__message.html#ga9ec4d67e6527397023d119ae81f57c03">pn_message_get_content_encoding</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00506"></a><span class="lineno"> 506</span> <span class="comment"></span></div><div class="line"><a name="l00507"></a><span class="lineno"> 507</span> <span class="comment">/**</span></div><div class="line"><a name="l00508"></a><span class="lineno"> 508</span> <span class="comment"> * Set the content_encoding for a message.</span></div><div class="line"><a name="l00509"></a><span class="lineno"> 509</span> <span class="comment"> *</span></div><div class="line"><a name="l00510"></a><span class="lineno"> 510</span> <span class="comment"> * The supplied content_encoding pointer must either be NULL or reference a NUL</span></div><div class="line"><a name="l00511"></a><span class="lineno"> 511</span> <span class="comment"> * terminated string. When the pointer is NULL, the content_encoding is set to</span></div><div class="line"><a name="l00512"></a><span class="lineno"> 512</span> <span class="comment"> * NULL. When the pointer is non NULL, the contents are copied into</span></div><div class="line"><a name="l00513"></a><span class="lineno"> 513</span> <span class="comment"> * the message.</span></div><div class="line"><a name="l00514"></a><span class="lineno"> 514</span> <span class="comment"> *</span></div><div class="line"><a name="l00515"></a><span class="lineno"> 515</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00516"></a><span class="lineno"> 516</span> <span class="comment"> * @param[in] encoding a pointer to the new content_encoding (or NULL)</span></div><div class="line"><a name="l00517"></a><span class="lineno"> 517</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00518"></a><span class="lineno"> 518</span> <span class="comment"> */</span></div><div class="line"><a name="l00519"></a><span class="lineno"> 519</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga39f2990e3a541fd9371d7dfb3ca82953">pn_message_set_content_encoding</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keyword">const</span> <span class="keywordtype">char</span> *encoding);</div><div class="line"><a name="l00520"></a><span class="lineno"> 520</span> <span class="comment"></span></div><div class="line"><a name="l00521"></a><span class="lineno"> 521</span> <span class="comment">/**</span></div><div class="line"><a name="l00522"></a><span class="lineno"> 522</span> <span class="comment"> * Get the expiry time for a message.</span></div><div class="line"><a name="l00523"></a><span class="lineno"> 523</span> <span class="comment"> *</span></div><div class="line"><a name="l00524"></a><span class="lineno"> 524</span> <span class="comment"> * A zero value for the expiry time indicates that the message will</span></div><div class="line"><a name="l00525"></a><span class="lineno"> 525</span> <span class="comment"> * never expire. This is the default value.</span></div><div class="line"><a name="l00526"></a><span class="lineno"> 526</span> <span class="comment"> *</span></div><div class="line"><a name="l00527"></a><span class="lineno"> 527</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00528"></a><span class="lineno"> 528</span> <span class="comment"> * @return the expiry time for the message</span></div><div class="line"><a name="l00529"></a><span class="lineno"> 529</span> <span class="comment"> */</span></div><div class="line"><a name="l00530"></a><span class="lineno"> 530</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__primitives.html#gad337c365b498106064ec28e00e5fb6dd">pn_timestamp_t</a> <a class="code" href="group__message.html#gab79cc8c5eb7352d82e8f5bbfbe06234c">pn_message_get_expiry_time</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00531"></a><span class="lineno"> 531</span> <span class="comment"></span></div><div class="line"><a name="l00532"></a><span class="lineno"> 532</span> <span class="comment">/**</span></div><div class="line"><a name="l00533"></a><span class="lineno"> 533</span> <span class="comment"> * Set the expiry time for a message.</span></div><div class="line"><a name="l00534"></a><span class="lineno"> 534</span> <span class="comment"> *</span></div><div class="line"><a name="l00535"></a><span class="lineno"> 535</span> <span class="comment"> * See ::pn_message_get_expiry_time() for more details.</span></div><div class="line"><a name="l00536"></a><span class="lineno"> 536</span> <span class="comment"> *</span></div><div class="line"><a name="l00537"></a><span class="lineno"> 537</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00538"></a><span class="lineno"> 538</span> <span class="comment"> * @param[in] time the new expiry time for the message</span></div><div class="line"><a name="l00539"></a><span class="lineno"> 539</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00540"></a><span class="lineno"> 540</span> <span class="comment"> */</span></div><div class="line"><a name="l00541"></a><span class="lineno"> 541</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#gad5044e606189589abafd65890d8824d8">pn_message_set_expiry_time</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <a class="code" href="group__primitives.html#gad337c365b498106064ec28e00e5fb6dd">pn_timestamp_t</a> time);</div><div class="line"><a name="l00542"></a><span class="lineno"> 542</span> <span class="comment"></span></div><div class="line"><a name="l00543"></a><span class="lineno"> 543</span> <span class="comment">/**</span></div><div class="line"><a name="l00544"></a><span class="lineno"> 544</span> <span class="comment"> * Get the creation time for a message.</span></div><div class="line"><a name="l00545"></a><span class="lineno"> 545</span> <span class="comment"> *</span></div><div class="line"><a name="l00546"></a><span class="lineno"> 546</span> <span class="comment"> * A zero value for the creation time indicates that the creation time</span></div><div class="line"><a name="l00547"></a><span class="lineno"> 547</span> <span class="comment"> * has not been set. This is the default value.</span></div><div class="line"><a name="l00548"></a><span class="lineno"> 548</span> <span class="comment"> *</span></div><div class="line"><a name="l00549"></a><span class="lineno"> 549</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00550"></a><span class="lineno"> 550</span> <span class="comment"> * @return the creation time for the message</span></div><div class="line"><a name="l00551"></a><span class="lineno"> 551</span> <span class="comment"> */</span></div><div class="line"><a name="l00552"></a><span class="lineno"> 552</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__primitives.html#gad337c365b498106064ec28e00e5fb6dd">pn_timestamp_t</a> <a class="code" href="group__message.html#gaaac9bf53b47cbfba119f47ecd08c6bc6">pn_message_get_creation_time</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00553"></a><span class="lineno"> 553</span> <span class="comment"></span></div><div class="line"><a name="l00554"></a><span class="lineno"> 554</span> <span class="comment">/**</span></div><div class="line"><a name="l00555"></a><span class="lineno"> 555</span> <span class="comment"> * Set the creation time for a message.</span></div><div class="line"><a name="l00556"></a><span class="lineno"> 556</span> <span class="comment"> *</span></div><div class="line"><a name="l00557"></a><span class="lineno"> 557</span> <span class="comment"> * See ::pn_message_get_creation_time() for more details.</span></div><div class="line"><a name="l00558"></a><span class="lineno"> 558</span> <span class="comment"> *</span></div><div class="line"><a name="l00559"></a><span class="lineno"> 559</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00560"></a><span class="lineno"> 560</span> <span class="comment"> * @param[in] time the new creation time for the message</span></div><div class="line"><a name="l00561"></a><span class="lineno"> 561</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00562"></a><span class="lineno"> 562</span> <span class="comment"> */</span></div><div class="line"><a name="l00563"></a><span class="lineno"> 563</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga7f328d0874a181f508b0af9eece5e95d">pn_message_set_creation_time</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <a class="code" href="group__primitives.html#gad337c365b498106064ec28e00e5fb6dd">pn_timestamp_t</a> time);</div><div class="line"><a name="l00564"></a><span class="lineno"> 564</span> <span class="comment"></span></div><div class="line"><a name="l00565"></a><span class="lineno"> 565</span> <span class="comment">/**</span></div><div class="line"><a name="l00566"></a><span class="lineno"> 566</span> <span class="comment"> * Get the group_id for a message.</span></div><div class="line"><a name="l00567"></a><span class="lineno"> 567</span> <span class="comment"> *</span></div><div class="line"><a name="l00568"></a><span class="lineno"> 568</span> <span class="comment"> * This operation will return NULL if no group_id has been set or if</span></div><div class="line"><a name="l00569"></a><span class="lineno"> 569</span> <span class="comment"> * the group_id has been set to NULL. The pointer returned by this</span></div><div class="line"><a name="l00570"></a><span class="lineno"> 570</span> <span class="comment"> * operation is valid until any one of the following operations occur:</span></div><div class="line"><a name="l00571"></a><span class="lineno"> 571</span> <span class="comment"> *</span></div><div class="line"><a name="l00572"></a><span class="lineno"> 572</span> <span class="comment"> * - ::pn_message_free()</span></div><div class="line"><a name="l00573"></a><span class="lineno"> 573</span> <span class="comment"> * - ::pn_message_clear()</span></div><div class="line"><a name="l00574"></a><span class="lineno"> 574</span> <span class="comment"> * - ::pn_message_set_group_id()</span></div><div class="line"><a name="l00575"></a><span class="lineno"> 575</span> <span class="comment"> *</span></div><div class="line"><a name="l00576"></a><span class="lineno"> 576</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00577"></a><span class="lineno"> 577</span> <span class="comment"> * @return a pointer to the group_id of the message (or NULL)</span></div><div class="line"><a name="l00578"></a><span class="lineno"> 578</span> <span class="comment"> */</span></div><div class="line"><a name="l00579"></a><span class="lineno"> 579</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keyword">const</span> <span class="keywordtype">char</span> * <a class="code" href="group__message.html#gaac9c32067e50f3279fe17b17a3b0cc7f">pn_message_get_group_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00580"></a><span class="lineno"> 580</span> <span class="comment"></span></div><div class="line"><a name="l00581"></a><span class="lineno"> 581</span> <span class="comment">/**</span></div><div class="line"><a name="l00582"></a><span class="lineno"> 582</span> <span class="comment"> * Set the group_id for a message.</span></div><div class="line"><a name="l00583"></a><span class="lineno"> 583</span> <span class="comment"> *</span></div><div class="line"><a name="l00584"></a><span class="lineno"> 584</span> <span class="comment"> * The supplied group_id pointer must either be NULL or reference a NUL</span></div><div class="line"><a name="l00585"></a><span class="lineno"> 585</span> <span class="comment"> * terminated string. When the pointer is NULL, the group_id is set to</span></div><div class="line"><a name="l00586"></a><span class="lineno"> 586</span> <span class="comment"> * NULL. When the pointer is non NULL, the contents are copied into</span></div><div class="line"><a name="l00587"></a><span class="lineno"> 587</span> <span class="comment"> * the message.</span></div><div class="line"><a name="l00588"></a><span class="lineno"> 588</span> <span class="comment"> *</span></div><div class="line"><a name="l00589"></a><span class="lineno"> 589</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00590"></a><span class="lineno"> 590</span> <span class="comment"> * @param[in] group_id a pointer to the new group_id (or NULL)</span></div><div class="line"><a name="l00591"></a><span class="lineno"> 591</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00592"></a><span class="lineno"> 592</span> <span class="comment"> */</span></div><div class="line"><a name="l00593"></a><span class="lineno"> 593</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga0ba2c671c5db93e8c7321ef6e66c962e">pn_message_set_group_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keyword">const</span> <span class="keywordtype">char</span> *group_id);</div><div class="line"><a name="l00594"></a><span class="lineno"> 594</span> <span class="comment"></span></div><div class="line"><a name="l00595"></a><span class="lineno"> 595</span> <span class="comment">/**</span></div><div class="line"><a name="l00596"></a><span class="lineno"> 596</span> <span class="comment"> * Get the group sequence for a message.</span></div><div class="line"><a name="l00597"></a><span class="lineno"> 597</span> <span class="comment"> *</span></div><div class="line"><a name="l00598"></a><span class="lineno"> 598</span> <span class="comment"> * The group sequence of a message identifies the relative ordering of</span></div><div class="line"><a name="l00599"></a><span class="lineno"> 599</span> <span class="comment"> * messages within a group. The default value for the group sequence</span></div><div class="line"><a name="l00600"></a><span class="lineno"> 600</span> <span class="comment"> * of a message is zero.</span></div><div class="line"><a name="l00601"></a><span class="lineno"> 601</span> <span class="comment"> *</span></div><div class="line"><a name="l00602"></a><span class="lineno"> 602</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00603"></a><span class="lineno"> 603</span> <span class="comment"> * @return the group sequence for the message</span></div><div class="line"><a name="l00604"></a><span class="lineno"> 604</span> <span class="comment"> */</span></div><div class="line"><a name="l00605"></a><span class="lineno"> 605</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__primitives.html#ga92033eaa8a158e7e4bb5d1f0e94ca606">pn_sequence_t</a> <a class="code" href="group__message.html#ga7820752b1c9d5f88e74d291e48fc1638">pn_message_get_group_sequence</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00606"></a><span class="lineno"> 606</span> <span class="comment"></span></div><div class="line"><a name="l00607"></a><span class="lineno"> 607</span> <span class="comment">/**</span></div><div class="line"><a name="l00608"></a><span class="lineno"> 608</span> <span class="comment"> * Set the group sequence for a message.</span></div><div class="line"><a name="l00609"></a><span class="lineno"> 609</span> <span class="comment"> *</span></div><div class="line"><a name="l00610"></a><span class="lineno"> 610</span> <span class="comment"> * See ::pn_message_get_group_sequence() for details on what the group</span></div><div class="line"><a name="l00611"></a><span class="lineno"> 611</span> <span class="comment"> * sequence means.</span></div><div class="line"><a name="l00612"></a><span class="lineno"> 612</span> <span class="comment"> *</span></div><div class="line"><a name="l00613"></a><span class="lineno"> 613</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00614"></a><span class="lineno"> 614</span> <span class="comment"> * @param[in] n the new group sequence for the message</span></div><div class="line"><a name="l00615"></a><span class="lineno"> 615</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00616"></a><span class="lineno"> 616</span> <span class="comment"> */</span></div><div class="line"><a name="l00617"></a><span class="lineno"> 617</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga31d881ca2663b0903f9a866da1e911ef">pn_message_set_group_sequence</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <a class="code" href="group__primitives.html#ga92033eaa8a158e7e4bb5d1f0e94ca606">pn_sequence_t</a> n);</div><div class="line"><a name="l00618"></a><span class="lineno"> 618</span> <span class="comment"></span></div><div class="line"><a name="l00619"></a><span class="lineno"> 619</span> <span class="comment">/**</span></div><div class="line"><a name="l00620"></a><span class="lineno"> 620</span> <span class="comment"> * Get the reply_to_group_id for a message.</span></div><div class="line"><a name="l00621"></a><span class="lineno"> 621</span> <span class="comment"> *</span></div><div class="line"><a name="l00622"></a><span class="lineno"> 622</span> <span class="comment"> * This operation will return NULL if no reply_to_group_id has been set or if</span></div><div class="line"><a name="l00623"></a><span class="lineno"> 623</span> <span class="comment"> * the reply_to_group_id has been set to NULL. The pointer returned by this</span></div><div class="line"><a name="l00624"></a><span class="lineno"> 624</span> <span class="comment"> * operation is valid until any one of the following operations occur:</span></div><div class="line"><a name="l00625"></a><span class="lineno"> 625</span> <span class="comment"> *</span></div><div class="line"><a name="l00626"></a><span class="lineno"> 626</span> <span class="comment"> * - ::pn_message_free()</span></div><div class="line"><a name="l00627"></a><span class="lineno"> 627</span> <span class="comment"> * - ::pn_message_clear()</span></div><div class="line"><a name="l00628"></a><span class="lineno"> 628</span> <span class="comment"> * - ::pn_message_set_reply_to_group_id()</span></div><div class="line"><a name="l00629"></a><span class="lineno"> 629</span> <span class="comment"> *</span></div><div class="line"><a name="l00630"></a><span class="lineno"> 630</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00631"></a><span class="lineno"> 631</span> <span class="comment"> * @return a pointer to the reply_to_group_id of the message (or NULL)</span></div><div class="line"><a name="l00632"></a><span class="lineno"> 632</span> <span class="comment"> */</span></div><div class="line"><a name="l00633"></a><span class="lineno"> 633</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keyword">const</span> <span class="keywordtype">char</span> * <a class="code" href="group__message.html#ga165beee02cfa76912ec7eb89e3869135">pn_message_get_reply_to_group_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00634"></a><span class="lineno"> 634</span> <span class="comment"></span></div><div class="line"><a name="l00635"></a><span class="lineno"> 635</span> <span class="comment">/**</span></div><div class="line"><a name="l00636"></a><span class="lineno"> 636</span> <span class="comment"> * Set the reply_to_group_id for a message.</span></div><div class="line"><a name="l00637"></a><span class="lineno"> 637</span> <span class="comment"> *</span></div><div class="line"><a name="l00638"></a><span class="lineno"> 638</span> <span class="comment"> * The supplied reply_to_group_id pointer must either be NULL or reference a NUL</span></div><div class="line"><a name="l00639"></a><span class="lineno"> 639</span> <span class="comment"> * terminated string. When the pointer is NULL, the reply_to_group_id is set to</span></div><div class="line"><a name="l00640"></a><span class="lineno"> 640</span> <span class="comment"> * NULL. When the pointer is non NULL, the contents are copied into</span></div><div class="line"><a name="l00641"></a><span class="lineno"> 641</span> <span class="comment"> * the message.</span></div><div class="line"><a name="l00642"></a><span class="lineno"> 642</span> <span class="comment"> *</span></div><div class="line"><a name="l00643"></a><span class="lineno"> 643</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00644"></a><span class="lineno"> 644</span> <span class="comment"> * @param[in] reply_to_group_id a pointer to the new reply_to_group_id (or NULL)</span></div><div class="line"><a name="l00645"></a><span class="lineno"> 645</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00646"></a><span class="lineno"> 646</span> <span class="comment"> */</span></div><div class="line"><a name="l00647"></a><span class="lineno"> 647</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga99fcb933bf3dc699a1b04027f770922e">pn_message_set_reply_to_group_id</a> (<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keyword">const</span> <span class="keywordtype">char</span> *reply_to_group_id);</div><div class="line"><a name="l00648"></a><span class="lineno"> 648</span> <span class="comment"></span></div><div class="line"><a name="l00649"></a><span class="lineno"> 649</span> <span class="comment">/**</span></div><div class="line"><a name="l00650"></a><span class="lineno"> 650</span> <span class="comment"> * Get/set the delivery instructions for a message.</span></div><div class="line"><a name="l00651"></a><span class="lineno"> 651</span> <span class="comment"> *</span></div><div class="line"><a name="l00652"></a><span class="lineno"> 652</span> <span class="comment"> * This operation returns a pointer to a ::pn_data_t representing the</span></div><div class="line"><a name="l00653"></a><span class="lineno"> 653</span> <span class="comment"> * content of the delivery instructions section of a message. The</span></div><div class="line"><a name="l00654"></a><span class="lineno"> 654</span> <span class="comment"> * pointer is valid until the message is freed and may be used to both</span></div><div class="line"><a name="l00655"></a><span class="lineno"> 655</span> <span class="comment"> * access and modify the content of the delivery instructions section</span></div><div class="line"><a name="l00656"></a><span class="lineno"> 656</span> <span class="comment"> * of a message.</span></div><div class="line"><a name="l00657"></a><span class="lineno"> 657</span> <span class="comment"> *</span></div><div class="line"><a name="l00658"></a><span class="lineno"> 658</span> <span class="comment"> * The ::pn_data_t must either be empty or consist of a symbol keyed</span></div><div class="line"><a name="l00659"></a><span class="lineno"> 659</span> <span class="comment"> * map in order to be considered valid delivery instructions.</span></div><div class="line"><a name="l00660"></a><span class="lineno"> 660</span> <span class="comment"> *</span></div><div class="line"><a name="l00661"></a><span class="lineno"> 661</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00662"></a><span class="lineno"> 662</span> <span class="comment"> * @return a pointer to the delivery instructions</span></div><div class="line"><a name="l00663"></a><span class="lineno"> 663</span> <span class="comment"> */</span></div><div class="line"><a name="l00664"></a><span class="lineno"> 664</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__data.html#ga5d6cf528776e8b6ad6d67caf095986bf">pn_data_t</a> *<a class="code" href="group__message.html#gae22d080b9928ac446349117783e5e1e7">pn_message_instructions</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00665"></a><span class="lineno"> 665</span> <span class="comment"></span></div><div class="line"><a name="l00666"></a><span class="lineno"> 666</span> <span class="comment">/**</span></div><div class="line"><a name="l00667"></a><span class="lineno"> 667</span> <span class="comment"> * Get/set the annotations for a message.</span></div><div class="line"><a name="l00668"></a><span class="lineno"> 668</span> <span class="comment"> *</span></div><div class="line"><a name="l00669"></a><span class="lineno"> 669</span> <span class="comment"> * This operation returns a pointer to a ::pn_data_t representing the</span></div><div class="line"><a name="l00670"></a><span class="lineno"> 670</span> <span class="comment"> * content of the annotations section of a message. The pointer is</span></div><div class="line"><a name="l00671"></a><span class="lineno"> 671</span> <span class="comment"> * valid until the message is freed and may be used to both access and</span></div><div class="line"><a name="l00672"></a><span class="lineno"> 672</span> <span class="comment"> * modify the content of the annotations section of a message.</span></div><div class="line"><a name="l00673"></a><span class="lineno"> 673</span> <span class="comment"> *</span></div><div class="line"><a name="l00674"></a><span class="lineno"> 674</span> <span class="comment"> * The ::pn_data_t must either be empty or consist of a symbol keyed</span></div><div class="line"><a name="l00675"></a><span class="lineno"> 675</span> <span class="comment"> * map in order to be considered valid message annotations.</span></div><div class="line"><a name="l00676"></a><span class="lineno"> 676</span> <span class="comment"> *</span></div><div class="line"><a name="l00677"></a><span class="lineno"> 677</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00678"></a><span class="lineno"> 678</span> <span class="comment"> * @return a pointer to the message annotations</span></div><div class="line"><a name="l00679"></a><span class="lineno"> 679</span> <span class="comment"> */</span></div><div class="line"><a name="l00680"></a><span class="lineno"> 680</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__data.html#ga5d6cf528776e8b6ad6d67caf095986bf">pn_data_t</a> *<a class="code" href="group__message.html#gac41af78e905b660a8df54baad6499a2d">pn_message_annotations</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00681"></a><span class="lineno"> 681</span> <span class="comment"></span></div><div class="line"><a name="l00682"></a><span class="lineno"> 682</span> <span class="comment">/**</span></div><div class="line"><a name="l00683"></a><span class="lineno"> 683</span> <span class="comment"> * Get/set the properties for a message.</span></div><div class="line"><a name="l00684"></a><span class="lineno"> 684</span> <span class="comment"> *</span></div><div class="line"><a name="l00685"></a><span class="lineno"> 685</span> <span class="comment"> * This operation returns a pointer to a ::pn_data_t representing the</span></div><div class="line"><a name="l00686"></a><span class="lineno"> 686</span> <span class="comment"> * content of the properties section of a message. The pointer is</span></div><div class="line"><a name="l00687"></a><span class="lineno"> 687</span> <span class="comment"> * valid until the message is freed and may be used to both access and</span></div><div class="line"><a name="l00688"></a><span class="lineno"> 688</span> <span class="comment"> * modify the content of the properties section of a message.</span></div><div class="line"><a name="l00689"></a><span class="lineno"> 689</span> <span class="comment"> *</span></div><div class="line"><a name="l00690"></a><span class="lineno"> 690</span> <span class="comment"> * The ::pn_data_t must either be empty or consist of a string keyed</span></div><div class="line"><a name="l00691"></a><span class="lineno"> 691</span> <span class="comment"> * map in order to be considered valid message properties.</span></div><div class="line"><a name="l00692"></a><span class="lineno"> 692</span> <span class="comment"> *</span></div><div class="line"><a name="l00693"></a><span class="lineno"> 693</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00694"></a><span class="lineno"> 694</span> <span class="comment"> * @return a pointer to the message properties</span></div><div class="line"><a name="l00695"></a><span class="lineno"> 695</span> <span class="comment"> */</span></div><div class="line"><a name="l00696"></a><span class="lineno"> 696</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__data.html#ga5d6cf528776e8b6ad6d67caf095986bf">pn_data_t</a> *<a class="code" href="group__message.html#ga197f2c80f13dbfc5ee5527d387a0beab">pn_message_properties</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00697"></a><span class="lineno"> 697</span> <span class="comment"></span></div><div class="line"><a name="l00698"></a><span class="lineno"> 698</span> <span class="comment">/**</span></div><div class="line"><a name="l00699"></a><span class="lineno"> 699</span> <span class="comment"> * Get/set the body of a message.</span></div><div class="line"><a name="l00700"></a><span class="lineno"> 700</span> <span class="comment"> *</span></div><div class="line"><a name="l00701"></a><span class="lineno"> 701</span> <span class="comment"> * This operation returns a pointer to a ::pn_data_t representing the</span></div><div class="line"><a name="l00702"></a><span class="lineno"> 702</span> <span class="comment"> * body of a message. The pointer is valid until the message is freed</span></div><div class="line"><a name="l00703"></a><span class="lineno"> 703</span> <span class="comment"> * and may be used to both access and modify the content of the</span></div><div class="line"><a name="l00704"></a><span class="lineno"> 704</span> <span class="comment"> * message body.</span></div><div class="line"><a name="l00705"></a><span class="lineno"> 705</span> <span class="comment"> *</span></div><div class="line"><a name="l00706"></a><span class="lineno"> 706</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00707"></a><span class="lineno"> 707</span> <span class="comment"> * @return a pointer to the message body</span></div><div class="line"><a name="l00708"></a><span class="lineno"> 708</span> <span class="comment"> */</span></div><div class="line"><a name="l00709"></a><span class="lineno"> 709</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <a class="code" href="group__data.html#ga5d6cf528776e8b6ad6d67caf095986bf">pn_data_t</a> *<a class="code" href="group__message.html#gad9c06e0d3ef5f2663fc5d8e2dd465ca3">pn_message_body</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg);</div><div class="line"><a name="l00710"></a><span class="lineno"> 710</span> <span class="comment"></span></div><div class="line"><a name="l00711"></a><span class="lineno"> 711</span> <span class="comment">/**</span></div><div class="line"><a name="l00712"></a><span class="lineno"> 712</span> <span class="comment"> * Decode/load message content from AMQP formatted binary data.</span></div><div class="line"><a name="l00713"></a><span class="lineno"> 713</span> <span class="comment"> *</span></div><div class="line"><a name="l00714"></a><span class="lineno"> 714</span> <span class="comment"> * Upon invoking this operation, any existing message content will be</span></div><div class="line"><a name="l00715"></a><span class="lineno"> 715</span> <span class="comment"> * cleared and replaced with the content from the provided binary</span></div><div class="line"><a name="l00716"></a><span class="lineno"> 716</span> <span class="comment"> * data.</span></div><div class="line"><a name="l00717"></a><span class="lineno"> 717</span> <span class="comment"> *</span></div><div class="line"><a name="l00718"></a><span class="lineno"> 718</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00719"></a><span class="lineno"> 719</span> <span class="comment"> * @param[in] bytes the start of the encoded AMQP data</span></div><div class="line"><a name="l00720"></a><span class="lineno"> 720</span> <span class="comment"> * @param[in] size the size of the encoded AMQP data</span></div><div class="line"><a name="l00721"></a><span class="lineno"> 721</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00722"></a><span class="lineno"> 722</span> <span class="comment"> */</span></div><div class="line"><a name="l00723"></a><span class="lineno"> 723</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga8e14c80d737f01e2a54b8198c48910d4">pn_message_decode</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keyword">const</span> <span class="keywordtype">char</span> *bytes, <span class="keywordtype">size_t</span> size);</div><div class="line"><a name="l00724"></a><span class="lineno"> 724</span> <span class="comment"></span></div><div class="line"><a name="l00725"></a><span class="lineno"> 725</span> <span class="comment">/**</span></div><div class="line"><a name="l00726"></a><span class="lineno"> 726</span> <span class="comment"> * Encode/save message content as AMQP formatted binary data.</span></div><div class="line"><a name="l00727"></a><span class="lineno"> 727</span> <span class="comment"> *</span></div><div class="line"><a name="l00728"></a><span class="lineno"> 728</span> <span class="comment"> * If the buffer space provided is insufficient to store the content</span></div><div class="line"><a name="l00729"></a><span class="lineno"> 729</span> <span class="comment"> * held in the message, the operation will fail and return a</span></div><div class="line"><a name="l00730"></a><span class="lineno"> 730</span> <span class="comment"> * ::PN_OVERFLOW error code.</span></div><div class="line"><a name="l00731"></a><span class="lineno"> 731</span> <span class="comment"> *</span></div><div class="line"><a name="l00732"></a><span class="lineno"> 732</span> <span class="comment"> * @param[in] msg a message object</span></div><div class="line"><a name="l00733"></a><span class="lineno"> 733</span> <span class="comment"> * @param[in] bytes the start of empty buffer space</span></div><div class="line"><a name="l00734"></a><span class="lineno"> 734</span> <span class="comment"> * @param[in] size the amount of empty buffer space</span></div><div class="line"><a name="l00735"></a><span class="lineno"> 735</span> <span class="comment"> * @param[out] size the amount of data written</span></div><div class="line"><a name="l00736"></a><span class="lineno"> 736</span> <span class="comment"> * @return zero on success or an error code on failure</span></div><div class="line"><a name="l00737"></a><span class="lineno"> 737</span> <span class="comment"> */</span></div><div class="line"><a name="l00738"></a><span class="lineno"> 738</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga9b9e3322a64a594001f1d97f7cf2affa">pn_message_encode</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <span class="keywordtype">char</span> *bytes, <span class="keywordtype">size_t</span> *size);</div><div class="line"><a name="l00739"></a><span class="lineno"> 739</span> <span class="comment"></span></div><div class="line"><a name="l00740"></a><span class="lineno"> 740</span> <span class="comment">/**</span></div><div class="line"><a name="l00741"></a><span class="lineno"> 741</span> <span class="comment"> * Save message content into a pn_data_t object data. The data object will first be cleared.</span></div><div class="line"><a name="l00742"></a><span class="lineno"> 742</span> <span class="comment"> */</span></div><div class="line"><a name="l00743"></a><span class="lineno"> 743</span> <a class="code" href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a> <span class="keywordtype">int</span> <a class="code" href="group__message.html#ga320d01b638a1780bebec73f4a943778a">pn_message_data</a>(<a class="code" href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a> *msg, <a class="code" href="group__data.html#ga5d6cf528776e8b6ad6d67caf095986bf">pn_data_t</a> *data);</div><div class="line"><a name="l00744"></a><span class="lineno"> 744</span> <span class="comment"></span></div><div class="line"><a name="l00745"></a><span class="lineno"> 745</span> <span class="comment">/** @}</span></div><div class="line"><a name="l00746"></a><span class="lineno"> 746</span> <span class="comment"> */</span></div><div class="line"><a name="l00747"></a><span class="lineno"> 747</span> </div><div class="line"><a name="l00748"></a><span class="lineno"> 748</span> <span class="preprocessor">#ifdef __cplusplus</span></div><div class="line"><a name="l00749"></a><span class="lineno"> 749</span> }</div><div class="line"><a name="l00750"></a><span class="lineno"> 750</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00751"></a><span class="lineno"> 751</span> </div><div class="line"><a name="l00752"></a><span class="lineno"> 752</span> <span class="preprocessor">#endif </span><span class="comment">/* message.h */</span><span class="preprocessor"></span></div><div class="ttc" id="group__message_html_gae22d080b9928ac446349117783e5e1e7"><div class="ttname"><a href="group__message.html#gae22d080b9928ac446349117783e5e1e7">pn_message_instructions</a></div><div class="ttdeci">PN_EXTERN pn_data_t * pn_message_instructions(pn_message_t *msg)</div><div class="ttdoc">Get/set the delivery instructions for a message. </div></div>
<div class="ttc" id="group__message_html_gad63613b52062ab477ac9c32f7131cda4"><div class="ttname"><a href="group__message.html#gad63613b52062ab477ac9c32f7131cda4">pn_message_id</a></div><div class="ttdeci">PN_EXTERN pn_data_t * pn_message_id(pn_message_t *msg)</div><div class="ttdoc">Get/set the id for a message. </div></div>
<div class="ttc" id="group__message_html_ga31d881ca2663b0903f9a866da1e911ef"><div class="ttname"><a href="group__message.html#ga31d881ca2663b0903f9a866da1e911ef">pn_message_set_group_sequence</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_group_sequence(pn_message_t *msg, pn_sequence_t n)</div><div class="ttdoc">Set the group sequence for a message. </div></div>
<div class="ttc" id="types_8h_html"><div class="ttname"><a href="types_8h.html">types.h</a></div></div>
<div class="ttc" id="group__message_html_ga04aa890bc4ff9f182462cffd50029123"><div class="ttname"><a href="group__message.html#ga04aa890bc4ff9f182462cffd50029123">pn_message_set_reply_to</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_reply_to(pn_message_t *msg, const char *reply_to)</div><div class="ttdoc">Set the reply_to for a message. </div></div>
<div class="ttc" id="group__message_html_gad5044e606189589abafd65890d8824d8"><div class="ttname"><a href="group__message.html#gad5044e606189589abafd65890d8824d8">pn_message_set_expiry_time</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_expiry_time(pn_message_t *msg, pn_timestamp_t time)</div><div class="ttdoc">Set the expiry time for a message. </div></div>
<div class="ttc" id="group__message_html_ga39f2990e3a541fd9371d7dfb3ca82953"><div class="ttname"><a href="group__message.html#ga39f2990e3a541fd9371d7dfb3ca82953">pn_message_set_content_encoding</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_content_encoding(pn_message_t *msg, const char *encoding)</div><div class="ttdoc">Set the content_encoding for a message. </div></div>
<div class="ttc" id="import__export_8h_html"><div class="ttname"><a href="import__export_8h.html">import_export.h</a></div></div>
<div class="ttc" id="group__message_html_ga5878b877a0b119f9eb6a7a02bdda6358"><div class="ttname"><a href="group__message.html#ga5878b877a0b119f9eb6a7a02bdda6358">pn_message_set_priority</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_priority(pn_message_t *msg, uint8_t priority)</div><div class="ttdoc">Set the priority for a message. </div></div>
<div class="ttc" id="group__primitives_html_ga9a701bc6dc9af9f42c3f4679172a723c"><div class="ttname"><a href="group__primitives.html#ga9a701bc6dc9af9f42c3f4679172a723c">pn_millis_t</a></div><div class="ttdeci">uint32_t pn_millis_t</div><div class="ttdef"><b>Definition:</b> types.h:47</div></div>
<div class="ttc" id="group__message_html_gad9259fa9271e8844c8e05a7e8978e3b2"><div class="ttname"><a href="group__message.html#gad9259fa9271e8844c8e05a7e8978e3b2">pn_message_t</a></div><div class="ttdeci">struct pn_message_t pn_message_t</div><div class="ttdoc">An AMQP Message object. </div><div class="ttdef"><b>Definition:</b> message.h:49</div></div>
<div class="ttc" id="group__message_html_ga29d5812830f4379461472761cd5e056b"><div class="ttname"><a href="group__message.html#ga29d5812830f4379461472761cd5e056b">pn_message_set_durable</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_durable(pn_message_t *msg, bool durable)</div><div class="ttdoc">Set the durable flag for a message. </div></div>
<div class="ttc" id="group__message_html_ga99fcb933bf3dc699a1b04027f770922e"><div class="ttname"><a href="group__message.html#ga99fcb933bf3dc699a1b04027f770922e">pn_message_set_reply_to_group_id</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_reply_to_group_id(pn_message_t *msg, const char *reply_to_group_id)</div><div class="ttdoc">Set the reply_to_group_id for a message. </div></div>
<div class="ttc" id="group__message_html_ga85500c85e451bb223084a5261be4f107"><div class="ttname"><a href="group__message.html#ga85500c85e451bb223084a5261be4f107">pn_message_get_correlation_id</a></div><div class="ttdeci">PN_EXTERN pn_atom_t pn_message_get_correlation_id(pn_message_t *msg)</div><div class="ttdoc">Get the correlation id for a message. </div></div>
<div class="ttc" id="group__message_html_gaac9c32067e50f3279fe17b17a3b0cc7f"><div class="ttname"><a href="group__message.html#gaac9c32067e50f3279fe17b17a3b0cc7f">pn_message_get_group_id</a></div><div class="ttdeci">PN_EXTERN const char * pn_message_get_group_id(pn_message_t *msg)</div><div class="ttdoc">Get the group_id for a message. </div></div>
<div class="ttc" id="group__message_html_gadae5d992568a088c561e5ddcdde13705"><div class="ttname"><a href="group__message.html#gadae5d992568a088c561e5ddcdde13705">pn_message_set_address</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_address(pn_message_t *msg, const char *address)</div><div class="ttdoc">Set the address for a message. </div></div>
<div class="ttc" id="group__message_html_gad82108b69076e73f9a413297eb0fe93a"><div class="ttname"><a href="group__message.html#gad82108b69076e73f9a413297eb0fe93a">pn_message_clear</a></div><div class="ttdeci">PN_EXTERN void pn_message_clear(pn_message_t *msg)</div><div class="ttdoc">Clears the content of a pn_message_t. </div></div>
<div class="ttc" id="codec_8h_html"><div class="ttname"><a href="codec_8h.html">codec.h</a></div><div class="ttdoc">Data API for proton. </div></div>
<div class="ttc" id="group__message_html_ga8881958619bd06d75c0c6cfffc59ee07"><div class="ttname"><a href="group__message.html#ga8881958619bd06d75c0c6cfffc59ee07">pn_message_set_content_type</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_content_type(pn_message_t *msg, const char *type)</div><div class="ttdoc">Set the content_type for a message. </div></div>
<div class="ttc" id="group__message_html_ga165beee02cfa76912ec7eb89e3869135"><div class="ttname"><a href="group__message.html#ga165beee02cfa76912ec7eb89e3869135">pn_message_get_reply_to_group_id</a></div><div class="ttdeci">PN_EXTERN const char * pn_message_get_reply_to_group_id(pn_message_t *msg)</div><div class="ttdoc">Get the reply_to_group_id for a message. </div></div>
<div class="ttc" id="group__message_html_gaf5a583d0cc1ee1a91d02e3f772a25771"><div class="ttname"><a href="group__message.html#gaf5a583d0cc1ee1a91d02e3f772a25771">pn_message_get_subject</a></div><div class="ttdeci">PN_EXTERN const char * pn_message_get_subject(pn_message_t *msg)</div><div class="ttdoc">Get the subject for a message. </div></div>
<div class="ttc" id="group__message_html_gaaaa2eb9b3638f556a8e89643e7d5751d"><div class="ttname"><a href="group__message.html#gaaaa2eb9b3638f556a8e89643e7d5751d">pn_message_set_id</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_id(pn_message_t *msg, pn_atom_t id)</div><div class="ttdoc">Set the id for a message. </div></div>
<div class="ttc" id="group__message_html_gae6061ca4cd91f35db285ad4e736b4880"><div class="ttname"><a href="group__message.html#gae6061ca4cd91f35db285ad4e736b4880">pn_message_get_delivery_count</a></div><div class="ttdeci">PN_EXTERN uint32_t pn_message_get_delivery_count(pn_message_t *msg)</div><div class="ttdoc">Get the delivery count for a message. </div></div>
<div class="ttc" id="type__compat_8h_html"><div class="ttname"><a href="type__compat_8h.html">type_compat.h</a></div></div>
<div class="ttc" id="group__message_html_ga6dc34192b0b265792e80b909733fc446"><div class="ttname"><a href="group__message.html#ga6dc34192b0b265792e80b909733fc446">pn_message_get_id</a></div><div class="ttdeci">PN_EXTERN pn_atom_t pn_message_get_id(pn_message_t *msg)</div><div class="ttdoc">Get the id for a message. </div></div>
<div class="ttc" id="group__message_html_ga02854827986ba1b0e36d0005674661c4"><div class="ttname"><a href="group__message.html#ga02854827986ba1b0e36d0005674661c4">pn_message_free</a></div><div class="ttdeci">PN_EXTERN void pn_message_free(pn_message_t *msg)</div><div class="ttdoc">Free a previously constructed pn_message_t. </div></div>
<div class="ttc" id="import__export_8h_html_acfa9628d87130a64f95ee17c57a7c13b"><div class="ttname"><a href="import__export_8h.html#acfa9628d87130a64f95ee17c57a7c13b">PN_EXTERN</a></div><div class="ttdeci">#define PN_EXTERN</div><div class="ttdef"><b>Definition:</b> import_export.h:53</div></div>
<div class="ttc" id="structpn__bytes__t_html"><div class="ttname"><a href="structpn__bytes__t.html">pn_bytes_t</a></div><div class="ttdef"><b>Definition:</b> types.h:67</div></div>
<div class="ttc" id="group__message_html_ga7f328d0874a181f508b0af9eece5e95d"><div class="ttname"><a href="group__message.html#ga7f328d0874a181f508b0af9eece5e95d">pn_message_set_creation_time</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_creation_time(pn_message_t *msg, pn_timestamp_t time)</div><div class="ttdoc">Set the creation time for a message. </div></div>
<div class="ttc" id="group__message_html_ga98c45926c58fabb1465c59d9aa4056ff"><div class="ttname"><a href="group__message.html#ga98c45926c58fabb1465c59d9aa4056ff">pn_message_errno</a></div><div class="ttdeci">PN_EXTERN int pn_message_errno(pn_message_t *msg)</div><div class="ttdoc">Access the error code of a message. </div></div>
<div class="ttc" id="error_8h_html"><div class="ttname"><a href="error_8h.html">error.h</a></div></div>
<div class="ttc" id="group__message_html_ga8e14c80d737f01e2a54b8198c48910d4"><div class="ttname"><a href="group__message.html#ga8e14c80d737f01e2a54b8198c48910d4">pn_message_decode</a></div><div class="ttdeci">PN_EXTERN int pn_message_decode(pn_message_t *msg, const char *bytes, size_t size)</div><div class="ttdoc">Decode/load message content from AMQP formatted binary data. </div></div>
<div class="ttc" id="group__primitives_html_ga92033eaa8a158e7e4bb5d1f0e94ca606"><div class="ttname"><a href="group__primitives.html#ga92033eaa8a158e7e4bb5d1f0e94ca606">pn_sequence_t</a></div><div class="ttdeci">int32_t pn_sequence_t</div><div class="ttdef"><b>Definition:</b> types.h:46</div></div>
<div class="ttc" id="group__message_html_ga9b9e3322a64a594001f1d97f7cf2affa"><div class="ttname"><a href="group__message.html#ga9b9e3322a64a594001f1d97f7cf2affa">pn_message_encode</a></div><div class="ttdeci">PN_EXTERN int pn_message_encode(pn_message_t *msg, char *bytes, size_t *size)</div><div class="ttdoc">Encode/save message content as AMQP formatted binary data. </div></div>
<div class="ttc" id="group__message_html_ga197f2c80f13dbfc5ee5527d387a0beab"><div class="ttname"><a href="group__message.html#ga197f2c80f13dbfc5ee5527d387a0beab">pn_message_properties</a></div><div class="ttdeci">PN_EXTERN pn_data_t * pn_message_properties(pn_message_t *msg)</div><div class="ttdoc">Get/set the properties for a message. </div></div>
<div class="ttc" id="structpn__atom__t_html"><div class="ttname"><a href="structpn__atom__t.html">pn_atom_t</a></div><div class="ttdoc">A descriminated union that holds any scalar AMQP value. </div><div class="ttdef"><b>Definition:</b> codec.h:199</div></div>
<div class="ttc" id="group__message_html_gab79cc8c5eb7352d82e8f5bbfbe06234c"><div class="ttname"><a href="group__message.html#gab79cc8c5eb7352d82e8f5bbfbe06234c">pn_message_get_expiry_time</a></div><div class="ttdeci">PN_EXTERN pn_timestamp_t pn_message_get_expiry_time(pn_message_t *msg)</div><div class="ttdoc">Get the expiry time for a message. </div></div>
<div class="ttc" id="group__message_html_ga320d01b638a1780bebec73f4a943778a"><div class="ttname"><a href="group__message.html#ga320d01b638a1780bebec73f4a943778a">pn_message_data</a></div><div class="ttdeci">PN_EXTERN int pn_message_data(pn_message_t *msg, pn_data_t *data)</div><div class="ttdoc">Save message content into a pn_data_t object data. </div></div>
<div class="ttc" id="group__message_html_gaa0a2a7abe7f484b5f4d5d7168d082c8e"><div class="ttname"><a href="group__message.html#gaa0a2a7abe7f484b5f4d5d7168d082c8e">pn_message_set_inferred</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_inferred(pn_message_t *msg, bool inferred)</div><div class="ttdoc">Set the inferred flag for a message. </div></div>
<div class="ttc" id="group__message_html_ga87bacde8d1733671663832dbb9fd097c"><div class="ttname"><a href="group__message.html#ga87bacde8d1733671663832dbb9fd097c">pn_message_error</a></div><div class="ttdeci">PN_EXTERN pn_error_t * pn_message_error(pn_message_t *msg)</div><div class="ttdoc">Access the error information for a message. </div></div>
<div class="ttc" id="group__message_html_gaf0df7d607fb85c78ada340df52db745c"><div class="ttname"><a href="group__message.html#gaf0df7d607fb85c78ada340df52db745c">pn_message_get_priority</a></div><div class="ttdeci">PN_EXTERN uint8_t pn_message_get_priority(pn_message_t *msg)</div><div class="ttdoc">Get the priority for a message. </div></div>
<div class="ttc" id="group__message_html_ga8cb345cb31c3a3349688799b6b4f2006"><div class="ttname"><a href="group__message.html#ga8cb345cb31c3a3349688799b6b4f2006">pn_message_get_address</a></div><div class="ttdeci">PN_EXTERN const char * pn_message_get_address(pn_message_t *msg)</div><div class="ttdoc">Get the address for a message. </div></div>
<div class="ttc" id="group__data_html_ga5d6cf528776e8b6ad6d67caf095986bf"><div class="ttname"><a href="group__data.html#ga5d6cf528776e8b6ad6d67caf095986bf">pn_data_t</a></div><div class="ttdeci">struct pn_data_t pn_data_t</div><div class="ttdoc">An AMQP Data object. </div><div class="ttdef"><b>Definition:</b> codec.h:358</div></div>
<div class="ttc" id="group__message_html_ga147807825163b84d9fdd7556fad42608"><div class="ttname"><a href="group__message.html#ga147807825163b84d9fdd7556fad42608">pn_message_is_first_acquirer</a></div><div class="ttdeci">PN_EXTERN bool pn_message_is_first_acquirer(pn_message_t *msg)</div><div class="ttdoc">Get the first acquirer flag for a message. </div></div>
<div class="ttc" id="group__message_html_gab10575fed8437d431da449e04f835f6d"><div class="ttname"><a href="group__message.html#gab10575fed8437d431da449e04f835f6d">pn_message_set_user_id</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_user_id(pn_message_t *msg, pn_bytes_t user_id)</div><div class="ttdoc">Set the user id for a message. </div></div>
<div class="ttc" id="group__message_html_ga8b7dbd80b354c3e1210bd7d223c08d64"><div class="ttname"><a href="group__message.html#ga8b7dbd80b354c3e1210bd7d223c08d64">pn_message_get_content_type</a></div><div class="ttdeci">PN_EXTERN const char * pn_message_get_content_type(pn_message_t *msg)</div><div class="ttdoc">Get the content_type for a message. </div></div>
<div class="ttc" id="group__message_html_gac41af78e905b660a8df54baad6499a2d"><div class="ttname"><a href="group__message.html#gac41af78e905b660a8df54baad6499a2d">pn_message_annotations</a></div><div class="ttdeci">PN_EXTERN pn_data_t * pn_message_annotations(pn_message_t *msg)</div><div class="ttdoc">Get/set the annotations for a message. </div></div>
<div class="ttc" id="group__message_html_ga9bc059be1b3f8b48e3e02d03bd0e31cf"><div class="ttname"><a href="group__message.html#ga9bc059be1b3f8b48e3e02d03bd0e31cf">pn_message_get_ttl</a></div><div class="ttdeci">PN_EXTERN pn_millis_t pn_message_get_ttl(pn_message_t *msg)</div><div class="ttdoc">Get the ttl for a message. </div></div>
<div class="ttc" id="group__message_html_ga9ec4d67e6527397023d119ae81f57c03"><div class="ttname"><a href="group__message.html#ga9ec4d67e6527397023d119ae81f57c03">pn_message_get_content_encoding</a></div><div class="ttdeci">PN_EXTERN const char * pn_message_get_content_encoding(pn_message_t *msg)</div><div class="ttdoc">Get the content_encoding for a message. </div></div>
<div class="ttc" id="group__primitives_html_gad337c365b498106064ec28e00e5fb6dd"><div class="ttname"><a href="group__primitives.html#gad337c365b498106064ec28e00e5fb6dd">pn_timestamp_t</a></div><div class="ttdeci">int64_t pn_timestamp_t</div><div class="ttdef"><b>Definition:</b> types.h:51</div></div>
<div class="ttc" id="error_8h_html_a24a289d5b32c9bd8a775600a5af83d52"><div class="ttname"><a href="error_8h.html#a24a289d5b32c9bd8a775600a5af83d52">pn_error_t</a></div><div class="ttdeci">struct pn_error_t pn_error_t</div><div class="ttdoc">A pn_error_t has an int error code and some string text to describe the error. </div><div class="ttdef"><b>Definition:</b> error.h:33</div></div>
<div class="ttc" id="group__message_html_gad8cc824cf918cec1a53816c15527322a"><div class="ttname"><a href="group__message.html#gad8cc824cf918cec1a53816c15527322a">pn_message_set_correlation_id</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_correlation_id(pn_message_t *msg, pn_atom_t id)</div><div class="ttdoc">Set the correlation id for a message. </div></div>
<div class="ttc" id="group__message_html_ga9e29a74bbaf88a38d488df17940f637a"><div class="ttname"><a href="group__message.html#ga9e29a74bbaf88a38d488df17940f637a">pn_message_set_delivery_count</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_delivery_count(pn_message_t *msg, uint32_t count)</div><div class="ttdoc">Set the delivery count for a message. </div></div>
<div class="ttc" id="group__message_html_ga19e41e8cfac95c2cd0f77a92c4ec85eb"><div class="ttname"><a href="group__message.html#ga19e41e8cfac95c2cd0f77a92c4ec85eb">pn_message_is_inferred</a></div><div class="ttdeci">PN_EXTERN bool pn_message_is_inferred(pn_message_t *msg)</div><div class="ttdoc">Get the inferred flag for a message. </div></div>
<div class="ttc" id="group__message_html_gafe7577a90ec17ff77af79e1b544557d7"><div class="ttname"><a href="group__message.html#gafe7577a90ec17ff77af79e1b544557d7">pn_message_get_reply_to</a></div><div class="ttdeci">PN_EXTERN const char * pn_message_get_reply_to(pn_message_t *msg)</div><div class="ttdoc">Get the reply_to for a message. </div></div>
<div class="ttc" id="group__message_html_gaafc66aca1184747edac543e9a3985a24"><div class="ttname"><a href="group__message.html#gaafc66aca1184747edac543e9a3985a24">pn_message_set_subject</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_subject(pn_message_t *msg, const char *subject)</div><div class="ttdoc">Set the subject for a message. </div></div>
<div class="ttc" id="group__message_html_ga0639e7686a2fdaabec64e26675fa805a"><div class="ttname"><a href="group__message.html#ga0639e7686a2fdaabec64e26675fa805a">pn_message_is_durable</a></div><div class="ttdeci">PN_EXTERN bool pn_message_is_durable(pn_message_t *msg)</div><div class="ttdoc">Get the durable flag for a message. </div></div>
<div class="ttc" id="group__message_html_gab420ee7f0d06a3771e27b3bc0d97ded2"><div class="ttname"><a href="group__message.html#gab420ee7f0d06a3771e27b3bc0d97ded2">pn_message_get_user_id</a></div><div class="ttdeci">PN_EXTERN pn_bytes_t pn_message_get_user_id(pn_message_t *msg)</div><div class="ttdoc">Get the user id for a message. </div></div>
<div class="ttc" id="group__message_html_gad9c06e0d3ef5f2663fc5d8e2dd465ca3"><div class="ttname"><a href="group__message.html#gad9c06e0d3ef5f2663fc5d8e2dd465ca3">pn_message_body</a></div><div class="ttdeci">PN_EXTERN pn_data_t * pn_message_body(pn_message_t *msg)</div><div class="ttdoc">Get/set the body of a message. </div></div>
<div class="ttc" id="group__message_html_ga29b1ebb0e3d0f4663e679eb92b5dfdb9"><div class="ttname"><a href="group__message.html#ga29b1ebb0e3d0f4663e679eb92b5dfdb9">pn_message</a></div><div class="ttdeci">PN_EXTERN pn_message_t * pn_message(void)</div><div class="ttdoc">Construct a new pn_message_t. </div></div>
<div class="ttc" id="group__message_html_gaa030d35726172445701c3abd365717b3"><div class="ttname"><a href="group__message.html#gaa030d35726172445701c3abd365717b3">pn_message_correlation_id</a></div><div class="ttdeci">PN_EXTERN pn_data_t * pn_message_correlation_id(pn_message_t *msg)</div><div class="ttdoc">Get/set the correlation id for a message. </div></div>
<div class="ttc" id="group__message_html_ga231109a27ed77c5440f5fd5e8e271dc3"><div class="ttname"><a href="group__message.html#ga231109a27ed77c5440f5fd5e8e271dc3">pn_message_set_ttl</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_ttl(pn_message_t *msg, pn_millis_t ttl)</div><div class="ttdoc">Set the ttl for a message. </div></div>
<div class="ttc" id="group__message_html_gaaac9bf53b47cbfba119f47ecd08c6bc6"><div class="ttname"><a href="group__message.html#gaaac9bf53b47cbfba119f47ecd08c6bc6">pn_message_get_creation_time</a></div><div class="ttdeci">PN_EXTERN pn_timestamp_t pn_message_get_creation_time(pn_message_t *msg)</div><div class="ttdoc">Get the creation time for a message. </div></div>
<div class="ttc" id="group__message_html_ga00b7a4b62de07b070191398e1f1cff02"><div class="ttname"><a href="group__message.html#ga00b7a4b62de07b070191398e1f1cff02">pn_message_set_first_acquirer</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_first_acquirer(pn_message_t *msg, bool first)</div><div class="ttdoc">Set the first acquirer flag for a message. </div></div>
<div class="ttc" id="group__message_html_ga7820752b1c9d5f88e74d291e48fc1638"><div class="ttname"><a href="group__message.html#ga7820752b1c9d5f88e74d291e48fc1638">pn_message_get_group_sequence</a></div><div class="ttdeci">PN_EXTERN pn_sequence_t pn_message_get_group_sequence(pn_message_t *msg)</div><div class="ttdoc">Get the group sequence for a message. </div></div>
<div class="ttc" id="group__message_html_ga0ba2c671c5db93e8c7321ef6e66c962e"><div class="ttname"><a href="group__message.html#ga0ba2c671c5db93e8c7321ef6e66c962e">pn_message_set_group_id</a></div><div class="ttdeci">PN_EXTERN int pn_message_set_group_id(pn_message_t *msg, const char *group_id)</div><div class="ttdoc">Set the group_id for a message. </div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Sun Feb 4 2018 22:16:50 for proton by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.13
</small></address>
</body>
</html>
|