class_c_sgip.html

用c++编写的的中国联通Sgip协议

          <td>(</td>
          <td class="paramtype">BOOL&nbsp;</td>
          <td class="paramname"> <em>forceRelease</em> = <code>FALSE</code>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
断开连接,停止线程池,释放资源 <dl compact><dt><b>参数: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em>forceRelease</em>&nbsp;</td><td>
如果Start没有启动成功,是否强制释放 </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="e6f75c1363619101d9b08d4c97fc7739"></a><!-- doxytag: member="CSgip::Submit" ref="e6f75c1363619101d9b08d4c97fc7739" args="(sgipg_submit ss, unsigned &amp;nSeq, unsigned &amp;nDateTime)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void CSgip::Submit           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structsgipg__submit.html">sgipg_submit</a>&nbsp;</td>
          <td class="paramname"> <em>ss</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">unsigned &amp;&nbsp;</td>
          <td class="paramname"> <em>nSeq</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">unsigned &amp;&nbsp;</td>
          <td class="paramname"> <em>nDateTime</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
提交MT消息 nDatetime(submit包的时间戳,序列号中的第二个字段), 与nSeq结合能够做到唯一标识一条submit消息(即使系统重新启动,nSeq重新归零). <dl compact><dt><b>参数: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em>ss</em>&nbsp;</td><td>
Submit消息包 </td></tr>
<tr><td valign="top"><em>nSeq</em>&nbsp;</td><td>
该消息包的序列号中的序列号 </td></tr>
<tr><td valign="top"><em>nDateTime</em>&nbsp;</td><td>
该消息包的序列号中的时间戳 </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="a47f6be2419f58287f9e80030b1dd1bf"></a><!-- doxytag: member="CSgip::AddUserNumber" ref="a47f6be2419f58287f9e80030b1dd1bf" args="(sgipg_submit *ss, const char *sUserNumber)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int CSgip::AddUserNumber           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structsgipg__submit.html">sgipg_submit</a> *&nbsp;</td>
          <td class="paramname"> <em>ss</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>sUserNumber</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
支持群发的设置目的号码的函数. sUserNumber可以是单个的手机号码，或者以逗号，中划线隔开的多个号码. 可以是以下几种类型之一,例如:"8613312345678",或"8613312345678,86133123456789", 或"8613312345670-8613312345679",或"8613312345670,8613312345675-8613312345689",或"8613012345678,8613012345679-8613012345688,8613312312312"。 <dl compact><dt><b>参数: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em>ss</em>&nbsp;</td><td>
要群发的消息包 </td></tr>
<tr><td valign="top"><em>sUserNumber</em>&nbsp;</td><td>
要增加的群发手机号 </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="67bffd65e50705231cd45a22dd462d49"></a><!-- doxytag: member="CSgip::GetSubmitSeqId" ref="67bffd65e50705231cd45a22dd462d49" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">unsigned int CSgip::GetSubmitSeqId           </td>
          <td>(</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
得到下一条要发submit消息的序列号 
</div>
</div><p>
<a class="anchor" name="d0e228589d6e79898f4c4231f18eff3a"></a><!-- doxytag: member="CSgip::GetSmgConnInfo" ref="d0e228589d6e79898f4c4231f18eff3a" args="(cList &amp;_connList)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void CSgip::GetSmgConnInfo           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="sgipapi_8h.html#6bb1a0f40aa99b1fb187bbe99d83cde5">cList</a> &amp;&nbsp;</td>
          <td class="paramname"> <em>_connList</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
得到当前网关到SP的连接信息 
</div>
</div><p>
<a class="anchor" name="2e974c38429f33a38c7b3855b12a4e8c"></a><!-- doxytag: member="CSgip::GetSmgConnCount" ref="2e974c38429f33a38c7b3855b12a4e8c" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">unsigned CSgip::GetSmgConnCount           </td>
          <td>(</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
得到当前网关到SP的连接数 
</div>
</div><p>
<a class="anchor" name="e236f10a811f3701a1021c1c4dc4cc11"></a><!-- doxytag: member="CSgip::OnDeliver" ref="e236f10a811f3701a1021c1c4dc4cc11" args="(DeliverStr &amp;deliver)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual int CSgip::OnDeliver           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structdeliverstr.html">DeliverStr</a> &amp;&nbsp;</td>
          <td class="paramname"> <em>deliver</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [inline, virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
收到DELIVER上行消息时调用该函数 
</div>
</div><p>
<a class="anchor" name="e3e3040d050469e9c27f937db45b3c03"></a><!-- doxytag: member="CSgip::OnReport" ref="e3e3040d050469e9c27f937db45b3c03" args="(ReportStr &amp;report)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual int CSgip::OnReport           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structreportstr.html">ReportStr</a> &amp;&nbsp;</td>
          <td class="paramname"> <em>report</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [inline, virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
收到状态报告时调用该函数 
</div>
</div><p>
<a class="anchor" name="ed068490757be58db438563d72160745"></a><!-- doxytag: member="CSgip::OnResponse" ref="ed068490757be58db438563d72160745" args="(MTRespStr &amp;response)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual int CSgip::OnResponse           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmtrespstr.html">MTRespStr</a> &amp;&nbsp;</td>
          <td class="paramname"> <em>response</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [inline, virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
收到Submit应答消息时调用此函数 
</div>
</div><p>
<a class="anchor" name="bfe3bfca8e85151422b7d3a8204933ba"></a><!-- doxytag: member="CSgip::OnMTError" ref="bfe3bfca8e85151422b7d3a8204933ba" args="(MTErrorStr mterror)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual int CSgip::OnMTError           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structmterrorstr.html">MTErrorStr</a>&nbsp;</td>
          <td class="paramname"> <em>mterror</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [inline, virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
发送SUBMIT消息失败时调用该函数<p>
MT_Error的错误码描述: 1：因为连接不上SMG网关系统 2：登录网关失败 3：包发送失败且超过重发次数 4.超时无应答 5.消息长度为零 6.没有可用的连接 
</div>
</div><p>
<a class="anchor" name="58a6b612fb3a92b112d562d56a5e5568"></a><!-- doxytag: member="CSgip::OnLogWrite" ref="58a6b612fb3a92b112d562d56a5e5568" args="(const char *pchFmt,...)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual int CSgip::OnLogWrite           </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>pchFmt</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">&nbsp;</td>
          <td class="paramname"> <em>...</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"><code> [inline, virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
记录日志函数 
</div>
</div><p>
<a class="anchor" name="794db715722fdeccad220815ad09c062"></a><!-- doxytag: member="CSgip::GetSubmitCount" ref="794db715722fdeccad220815ad09c062" args="() const" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">long CSgip::GetSubmitCount           </td>
          <td>(</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
得到提交的SUBMIT消息数 
</div>
</div><p>
<a class="anchor" name="ca9c8c88d7a296740f00b8d891680e2d"></a><!-- doxytag: member="CSgip::GetSubmitSucceedCount" ref="ca9c8c88d7a296740f00b8d891680e2d" args="() const" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">long CSgip::GetSubmitSucceedCount           </td>
          <td>(</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"> const<code> [inline]</code></td>