<!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"/>
<title>liblinphone: Initializing liblinphone</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="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 style="padding-left: 0.5em;">
<div id="projectname">liblinphone
 <span id="projectnumber">3.5.2</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.1.2 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Initializing liblinphone</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="struct__LinphoneVTable.html">_LinphoneVTable</a></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:gaa5cf635b82dd338e7ee2dd3599d05f0a"><td class="memItemLeft" align="right" valign="top">typedef struct _LinphoneCore </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a></td></tr>
<tr class="memitem:gae852b5b31d6d5e673de9d2c9b63aca7e"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__initializing.html#ga3bca1685790c41a1729e88af318ffb1c">_LinphoneGlobalState</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gae852b5b31d6d5e673de9d2c9b63aca7e">LinphoneGlobalState</a></td></tr>
<tr class="memitem:ga43f7be5965383fae304e3053ffdc7e7f"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga43f7be5965383fae304e3053ffdc7e7f">LinphoneGlobalStateCb</a> )(struct _LinphoneCore *lc, <a class="el" href="group__initializing.html#gae852b5b31d6d5e673de9d2c9b63aca7e">LinphoneGlobalState</a> gstate, const char *message)</td></tr>
<tr class="memitem:gacf692730f4aceefa92422d128cc4c069"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gacf692730f4aceefa92422d128cc4c069">LinphoneCallStateCb</a> )(struct _LinphoneCore *lc, LinphoneCall *call, <a class="el" href="group__call__control.html#ga37dad1a4f935d9cc26ec1f9d2b23691a">LinphoneCallState</a> cstate, const char *message)</td></tr>
<tr class="memitem:gab6e92e471a14b2dc5c513e2cab066133"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gab6e92e471a14b2dc5c513e2cab066133">CallEncryptionChangedCb</a> )(struct _LinphoneCore *lc, LinphoneCall *call, bool_t on, const char *authentication_token)</td></tr>
<tr class="memitem:gae2118ee5fdce307bd608a2d40bfa3829"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gae2118ee5fdce307bd608a2d40bfa3829">LinphoneRegistrationStateCb</a> )(struct _LinphoneCore *lc, <a class="el" href="group__proxies.html#ga1879a0d59e068457b688138da97f2d0b">LinphoneProxyConfig</a> *cfg, <a class="el" href="group__proxies.html#ga698cb4228fac724b9e7c3cc5f499f7a8">LinphoneRegistrationState</a> cstate, const char *message)</td></tr>
<tr class="memitem:ga1efc828e75f40ceb0498aa113404d9c5"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga1efc828e75f40ceb0498aa113404d9c5">ShowInterfaceCb</a> )(struct _LinphoneCore *lc)</td></tr>
<tr class="memitem:gaa641595735c115fe26902aa31a5b8d44"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gaa641595735c115fe26902aa31a5b8d44">DisplayStatusCb</a> )(struct _LinphoneCore *lc, const char *message)</td></tr>
<tr class="memitem:ga30f12b0b8f25375dd7338cd920d7e107"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga30f12b0b8f25375dd7338cd920d7e107">DisplayMessageCb</a> )(struct _LinphoneCore *lc, const char *message)</td></tr>
<tr class="memitem:ga4de4ea100f488d83d874325bccc5f82d"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga4de4ea100f488d83d874325bccc5f82d">DisplayUrlCb</a> )(struct _LinphoneCore *lc, const char *message, const char *url)</td></tr>
<tr class="memitem:ga7b33594493052b415638d601e0e0c4f4"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga7b33594493052b415638d601e0e0c4f4">LinphoneCoreCbFunc</a> )(struct _LinphoneCore *lc, void *user_data)</td></tr>
<tr class="memitem:gae2fb7f03c3ce67ad4362cc71c8ce8de6"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gae2fb7f03c3ce67ad4362cc71c8ce8de6">NotifyReceivedCb</a> )(struct _LinphoneCore *lc, LinphoneCall *call, const char *from, const char *event)</td></tr>
<tr class="memitem:ga6cd8753afd60d2f2b34e6b7f3be1666a"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga6cd8753afd60d2f2b34e6b7f3be1666a">NotifyPresenceReceivedCb</a> )(struct _LinphoneCore *lc, <a class="el" href="group__buddy__list.html#ga2f0508bab6d8ded431ce8b1a679a1522">LinphoneFriend</a> *lf)</td></tr>
<tr class="memitem:gacea6471f30e2fcc601cec428fde57e9a"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gacea6471f30e2fcc601cec428fde57e9a">NewSubscribtionRequestCb</a> )(struct _LinphoneCore *lc, <a class="el" href="group__buddy__list.html#ga2f0508bab6d8ded431ce8b1a679a1522">LinphoneFriend</a> *lf, const char *url)</td></tr>
<tr class="memitem:ga2673e7baaa3ddec6190902fc76204b29"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga2673e7baaa3ddec6190902fc76204b29">AuthInfoRequested</a> )(struct _LinphoneCore *lc, const char *realm, const char *username)</td></tr>
<tr class="memitem:ga13c18ca9ea1289dcb40b47d149fba765"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga13c18ca9ea1289dcb40b47d149fba765">CallLogUpdated</a> )(struct _LinphoneCore *lc, struct <a class="el" href="struct__LinphoneCallLog.html">_LinphoneCallLog</a> *newcl)</td></tr>
<tr class="memitem:ga07b7506ff003f7fc9b819f95f3d1588f"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga07b7506ff003f7fc9b819f95f3d1588f">TextMessageReceived</a> )(<a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> *lc, <a class="el" href="group__chatroom.html#ga37902f3fc715b7f6451c241d0efd0299">LinphoneChatRoom</a> *room, const <a class="el" href="group__linphone__address.html#gaa017e66840f5ee578168bd469b6c3e91">LinphoneAddress</a> *from, const char *message)</td></tr>
<tr class="memitem:gacd78bd518b92f4368afccda59c43b4c8"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gacd78bd518b92f4368afccda59c43b4c8">DtmfReceived</a> )(struct _LinphoneCore *lc, LinphoneCall *call, int dtmf)</td></tr>
<tr class="memitem:ga4e9744cebbbd4287dfe7cfde41e91c45"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga4e9744cebbbd4287dfe7cfde41e91c45">ReferReceived</a> )(struct _LinphoneCore *lc, const char *refer_to)</td></tr>
<tr class="memitem:gab9d0aefcdffb933ddf9d8664ff740529"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gab9d0aefcdffb933ddf9d8664ff740529">BuddyInfoUpdated</a> )(struct _LinphoneCore *lc, <a class="el" href="group__buddy__list.html#ga2f0508bab6d8ded431ce8b1a679a1522">LinphoneFriend</a> *lf)</td></tr>
<tr class="memitem:ga189ef1b7d6caff6493dfd8311ec3e378"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="struct__LinphoneVTable.html">_LinphoneVTable</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga189ef1b7d6caff6493dfd8311ec3e378">LinphoneCoreVTable</a></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:gaf7346e9b3a064155f3d5d3811d684fb2"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gaf7346e9b3a064155f3d5d3811d684fb2">_LinphoneReason</a> { , <br/>
  <a class="el" href="group__initializing.html#ggaf7346e9b3a064155f3d5d3811d684fb2ac71a4d9109f8eb8a9f5961109d505331">LinphoneReasonNoResponse</a>,
<br/>
  <a class="el" href="group__initializing.html#ggaf7346e9b3a064155f3d5d3811d684fb2ad26546a581f2bfd58410f1f3d141666a">LinphoneReasonBadCredentials</a>,
<br/>
  <a class="el" href="group__initializing.html#ggaf7346e9b3a064155f3d5d3811d684fb2a442fce67ace6491eee2f4a94177f34c6">LinphoneReasonDeclined</a>
<br/>
}</td></tr>
<tr class="memitem:ga3bca1685790c41a1729e88af318ffb1c"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga3bca1685790c41a1729e88af318ffb1c">_LinphoneGlobalState</a> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gac93ed982ae84a5a282a703c8433ca42f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#gac93ed982ae84a5a282a703c8433ca42f">linphone_core_new</a> (const <a class="el" href="group__initializing.html#ga189ef1b7d6caff6493dfd8311ec3e378">LinphoneCoreVTable</a> *vtable, const char *config_path, const char *factory_config_path, void *userdata)</td></tr>
<tr class="memitem:ga7bdac8ac386483fc4e0876e4c5d13755"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga7bdac8ac386483fc4e0876e4c5d13755">linphone_core_iterate</a> (<a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> *lc)</td></tr>
<tr class="memitem:ga705206c56f9be737ce1eac53e5ba8b76"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga705206c56f9be737ce1eac53e5ba8b76">linphone_core_get_user_data</a> (<a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> *lc)</td></tr>
<tr class="memitem:ga5e3f2f87c8d8262caa1fa90bbd504008"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__initializing.html#ga5e3f2f87c8d8262caa1fa90bbd504008">linphone_core_destroy</a> (<a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> *lc)</td></tr>
</table>
<a name="details" id="details"></a><h2>Detailed Description</h2>
<h2>Typedef Documentation</h2>
<a class="anchor" id="gaa5cf635b82dd338e7ee2dd3599d05f0a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct _LinphoneCore <a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Linphone core main object created by function <a class="el" href="group__initializing.html#gac93ed982ae84a5a282a703c8433ca42f">linphone_core_new()</a> . </p>
</div>
</div>
<a class="anchor" id="gae852b5b31d6d5e673de9d2c9b63aca7e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="group__initializing.html#ga3bca1685790c41a1729e88af318ffb1c">_LinphoneGlobalState</a> <a class="el" href="group__initializing.html#gae852b5b31d6d5e673de9d2c9b63aca7e">LinphoneGlobalState</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>LinphoneGlobalState describes the global state of the LinphoneCore object. It is notified via the <a class="el" href="struct__LinphoneVTable.html#a96effce0671ecb15f6e8ee693632e29b">LinphoneCoreVTable::global_state_changed</a> </p>
</div>
</div>
<a class="anchor" id="ga43f7be5965383fae304e3053ffdc7e7f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* LinphoneGlobalStateCb)(struct _LinphoneCore *lc, <a class="el" href="group__initializing.html#gae852b5b31d6d5e673de9d2c9b63aca7e">LinphoneGlobalState</a> gstate, const char *message)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Call state notification callback prototype </p>
</div>
</div>
<a class="anchor" id="gacf692730f4aceefa92422d128cc4c069"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* LinphoneCallStateCb)(struct _LinphoneCore *lc, LinphoneCall *call, <a class="el" href="group__call__control.html#ga37dad1a4f935d9cc26ec1f9d2b23691a">LinphoneCallState</a> cstate, const char *message)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Call state notification callback prototype </p>
</div>
</div>
<a class="anchor" id="gab6e92e471a14b2dc5c513e2cab066133"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* CallEncryptionChangedCb)(struct _LinphoneCore *lc, LinphoneCall *call, bool_t on, const char *authentication_token)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Call encryption changed callback prototype </p>
</div>
</div>
<a class="anchor" id="gae2118ee5fdce307bd608a2d40bfa3829"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* LinphoneRegistrationStateCb)(struct _LinphoneCore *lc, <a class="el" href="group__proxies.html#ga1879a0d59e068457b688138da97f2d0b">LinphoneProxyConfig</a> *cfg, <a class="el" href="group__proxies.html#ga698cb4228fac724b9e7c3cc5f499f7a8">LinphoneRegistrationState</a> cstate, const char *message)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Registration state notification callback prototype </p>
</div>
</div>
<a class="anchor" id="ga1efc828e75f40ceb0498aa113404d9c5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* ShowInterfaceCb)(struct _LinphoneCore *lc)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="gaa641595735c115fe26902aa31a5b8d44"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* DisplayStatusCb)(struct _LinphoneCore *lc, const char *message)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="ga30f12b0b8f25375dd7338cd920d7e107"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* DisplayMessageCb)(struct _LinphoneCore *lc, const char *message)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="ga4de4ea100f488d83d874325bccc5f82d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* DisplayUrlCb)(struct _LinphoneCore *lc, const char *message, const char *url)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="ga7b33594493052b415638d601e0e0c4f4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* LinphoneCoreCbFunc)(struct _LinphoneCore *lc, void *user_data)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="gae2fb7f03c3ce67ad4362cc71c8ce8de6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* NotifyReceivedCb)(struct _LinphoneCore *lc, LinphoneCall *call, const char *from, const char *event)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="ga6cd8753afd60d2f2b34e6b7f3be1666a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* NotifyPresenceReceivedCb)(struct _LinphoneCore *lc, <a class="el" href="group__buddy__list.html#ga2f0508bab6d8ded431ce8b1a679a1522">LinphoneFriend</a> *lf)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Report status change for a friend previously <a class="el" href="group__buddy__list.html#ga3a8e9184320402082bf35226ae8d25b8">added </a> to <a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">lc</td><td><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> object . </td></tr>
<tr><td class="paramname">lf</td><td>Updated <a class="el" href="group__buddy__list.html#ga2f0508bab6d8ded431ce8b1a679a1522">LinphoneFriend</a> . </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gacea6471f30e2fcc601cec428fde57e9a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* NewSubscribtionRequestCb)(struct _LinphoneCore *lc, <a class="el" href="group__buddy__list.html#ga2f0508bab6d8ded431ce8b1a679a1522">LinphoneFriend</a> *lf, const char *url)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Reports that a new subscription request has been received and wait for a decision. <br/>
Status on this subscription request is notified by <a class="el" href="group__buddy__list.html#ga9ab0c9222edcc0a8e25fb068aee88bc0">changing policy </a> for this friend </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">lc</td><td><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> object </td></tr>
<tr><td class="paramname">lf</td><td><a class="el" href="group__buddy__list.html#ga2f0508bab6d8ded431ce8b1a679a1522">LinphoneFriend</a> corresponding to the subscriber </td></tr>
<tr><td class="paramname">url</td><td>of the subscriber Callback prototype </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga2673e7baaa3ddec6190902fc76204b29"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* AuthInfoRequested)(struct _LinphoneCore *lc, const char *realm, const char *username)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="ga13c18ca9ea1289dcb40b47d149fba765"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* CallLogUpdated)(struct _LinphoneCore *lc, struct <a class="el" href="struct__LinphoneCallLog.html">_LinphoneCallLog</a> *newcl)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="ga07b7506ff003f7fc9b819f95f3d1588f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* TextMessageReceived)(<a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> *lc, <a class="el" href="group__chatroom.html#ga37902f3fc715b7f6451c241d0efd0299">LinphoneChatRoom</a> *room, const <a class="el" href="group__linphone__address.html#gaa017e66840f5ee578168bd469b6c3e91">LinphoneAddress</a> *from, const char *message)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">lc</td><td><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> object </td></tr>
<tr><td class="paramname">room</td><td><a class="el" href="group__chatroom.html#ga37902f3fc715b7f6451c241d0efd0299">LinphoneChatRoom</a> involved in this conversation. Can be be created by the framework in case <a class="el" href="group__linphone__address.html#gaa017e66840f5ee578168bd469b6c3e91">the from </a> is not present in any chat room. </td></tr>
<tr><td class="paramname">from</td><td><a class="el" href="group__linphone__address.html#gaa017e66840f5ee578168bd469b6c3e91">LinphoneAddress</a> from </td></tr>
<tr><td class="paramname">message</td><td>incoming message </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gacd78bd518b92f4368afccda59c43b4c8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* DtmfReceived)(struct _LinphoneCore *lc, LinphoneCall *call, int dtmf)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="ga4e9744cebbbd4287dfe7cfde41e91c45"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* ReferReceived)(struct _LinphoneCore *lc, const char *refer_to)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="gab9d0aefcdffb933ddf9d8664ff740529"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* BuddyInfoUpdated)(struct _LinphoneCore *lc, <a class="el" href="group__buddy__list.html#ga2f0508bab6d8ded431ce8b1a679a1522">LinphoneFriend</a> *lf)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback prototype </p>
</div>
</div>
<a class="anchor" id="ga189ef1b7d6caff6493dfd8311ec3e378"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="struct__LinphoneVTable.html">_LinphoneVTable</a> <a class="el" href="group__initializing.html#ga189ef1b7d6caff6493dfd8311ec3e378">LinphoneCoreVTable</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>This structure holds all callbacks that the application should implement. None is mandatory. </p>
</div>
</div>
<h2>Enumeration Type Documentation</h2>
<a class="anchor" id="gaf7346e9b3a064155f3d5d3811d684fb2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__initializing.html#gaf7346e9b3a064155f3d5d3811d684fb2">_LinphoneReason</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Enum describing failure reasons. </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggaf7346e9b3a064155f3d5d3811d684fb2ac71a4d9109f8eb8a9f5961109d505331"></a>LinphoneReasonNoResponse</em> </td><td>
<p>No response received from remote </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaf7346e9b3a064155f3d5d3811d684fb2ad26546a581f2bfd58410f1f3d141666a"></a>LinphoneReasonBadCredentials</em> </td><td>
<p>Authentication failed due to bad or missing credentials </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaf7346e9b3a064155f3d5d3811d684fb2a442fce67ace6491eee2f4a94177f34c6"></a>LinphoneReasonDeclined</em> </td><td>
<p>The call has been declined </p>
</td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga3bca1685790c41a1729e88af318ffb1c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__initializing.html#ga3bca1685790c41a1729e88af318ffb1c">_LinphoneGlobalState</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>LinphoneGlobalState describes the global state of the LinphoneCore object. It is notified via the <a class="el" href="struct__LinphoneVTable.html#a96effce0671ecb15f6e8ee693632e29b">LinphoneCoreVTable::global_state_changed</a> </p>
</div>
</div>
<h2>Function Documentation</h2>
<a class="anchor" id="gac93ed982ae84a5a282a703c8433ca42f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a>* linphone_core_new </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__initializing.html#ga189ef1b7d6caff6493dfd8311ec3e378">LinphoneCoreVTable</a> * </td>
<td class="paramname"><em>vtable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>config_path</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>factory_config_path</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>userdata</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Instanciates a LinphoneCore object.</p>
<p>The LinphoneCore object is the primary handle for doing all phone actions. It should be unique within your application. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">vtable</td><td>a LinphoneCoreVTable structure holding your application callbacks </td></tr>
<tr><td class="paramname">config_path</td><td>a path to a config file. If it does not exists it will be created. The config file is used to store all settings, call logs, friends, proxies... so that all these settings become persistent over the life of the LinphoneCore object. It is allowed to set a NULL config file. In that case LinphoneCore will not store any settings. </td></tr>
<tr><td class="paramname">factory_config_path</td><td>a path to a read-only config file that can be used to to store hard-coded preference such as proxy settings or internal preferences. The settings in this factory file always override the one in the normal config file. It is OPTIONAL, use NULL if unneeded. </td></tr>
<tr><td class="paramname">userdata</td><td>an opaque user pointer that can be retrieved at any time (for example in callbacks) using <a class="el" href="group__initializing.html#ga705206c56f9be737ce1eac53e5ba8b76">linphone_core_get_user_data()</a>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga7bdac8ac386483fc4e0876e4c5d13755"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void linphone_core_iterate </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> * </td>
<td class="paramname"><em>lc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Main loop function. It is crucial that your application call it periodically.</p>
<p><a class="el" href="group__initializing.html#ga7bdac8ac386483fc4e0876e4c5d13755">linphone_core_iterate()</a> performs various backgrounds tasks:</p>
<ul>
<li>receiving of SIP messages</li>
<li>handles timers and timeout</li>
<li>performs registration to proxies</li>
<li>authentication retries The application MUST call this function periodically, in its main loop. Be careful that this function must be called from the same thread as other liblinphone methods. If it is not the case make sure all liblinphone calls are serialized with a mutex. </li>
</ul>
</div>
</div>
<a class="anchor" id="ga705206c56f9be737ce1eac53e5ba8b76"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* linphone_core_get_user_data </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> * </td>
<td class="paramname"><em>lc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Retrieves the user pointer that was given to <a class="el" href="group__initializing.html#gac93ed982ae84a5a282a703c8433ca42f">linphone_core_new()</a> </p>
</div>
</div>
<a class="anchor" id="ga5e3f2f87c8d8262caa1fa90bbd504008"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void linphone_core_destroy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__initializing.html#gaa5cf635b82dd338e7ee2dd3599d05f0a">LinphoneCore</a> * </td>
<td class="paramname"><em>lc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Destroys a LinphoneCore </p>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.1.2
</small></address>
</body>
</html>
