开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 多媒体 > IP电话/视频会议 > 查看源码
h4501suppserv.h
资源名称：h323.zip　[点击查看]
上传用户：hnnddl
上传日期：2007-01-06
资源大小：3580k
文件大小：15k
源码类别：

IP电话/视频会议

开发平台：

WINDOWS

h4501suppserv.h：源码内容
  1. //@DELB
  2. /*
  3.  * $Revision: 1.7 $
  4.  * $Date: 1998/12/21 16:51:46 $
  5.  */
  6. ////////////////////////////////////////////////////////////////
  7. //           Copyright (c) 1996 Lucent Technologies           //
  8. //                   All Rights Reserved                      //
  9. //                                                            //
  10. //                   THIS IS UNPUBLISHED                      //
  11. //                   PROPRIETARY SOURCE                       //
  12. //               CODE OF Lucent Technologies                  //
  13. //                       AND elemedia                         //
  14. //                                                            //
  15. //      The copyright notice above does not evidence any      //
  16. //     actual or intended publication of such source code     //
  17. ////////////////////////////////////////////////////////////////
  19. ////////////////////////////////////////////////////////////////
  20. // File : h4501suppserv.h                                     //
  21. //                                                            //
  22. //                                                            //
  23. // History:                                                   //
  24. //  28 July 1998 Created                                      //
  25. //                                                            //
  26. //                                                            //
  27. //////////////////////////////////////////////////////////////// 
  29. #if (!defined(__H4501SUPPSERV_H__))
  30. #define __H4501SUPPSERV_H__
  34. #include "api/h225types.h"
  35. #include "api/h450err.h"
  36. #include "api/h450types.h"
  37. #include "api/h4502resarg.h"
  38. #include "api/h4503types.h"
  39. #include "api/h4503resarg.h"
  42. // Forward declarations
  43. class H4501FacilityExt;
  44. class H4501ROS;
  45. class H4501Invoke;
  46. class H4501ReturnResult;
  47. class H4501ReturnError;
  48. class H4501Reject;
  49. class H4501SuppService;
  50. class ASN1Codec;
  52. struct EmNetworkFacilityExtension;
  53. struct EmROS;
  54. struct EmH4501SupplementaryService;
  56. #define PDUTYPE_INVALID -1
  58. //@DELE
  61. // -  enum Call Transfer Operation type.
  62. // @See:
  63. // - H4501Invoke H4501ReturnResult H4501Code
  64. enum H4502CTOperationType
  65. {
  66. CTOT_INVALID = 0, // invalid selection
  67. CTOT_IDENTIFY = 7, // callTransferIdentify OPERATION
  68. CTOT_ABANDON = 8, // callTransferAbondon OPERATION
  69. CTOT_INITIATE = 9, // callTransferInitiate OPERATION
  70. CTOT_SETUP = 10, // callTransferSetup OPERATION
  71. CTOT_ACTIVE = 11, // callTransferActive OPERATION
  72. CTOT_COMPLETE = 12, // callTransferComplete OPERATION
  73. CTOT_UPDATE = 13, // callTransferUpdate OPERATION
  74. CTOT_TRANSFER = 14 // subaddressTransfer OPERATION
  75. };
  77. // -  enum Call Diversion Operation type.
  78. // @See:
  79. //      - H4501Invoke H4501ReturnResult H4501Code
  80. enum H4503CDOperationType
  81. {
  82. CDOT_INVALID = 0,                   // invalid selection
  83. CDOT_ACTIVATEDIVERSIONQ = 15,       // activateDiversionQ
  84. CDOT_DEACTIVATEDIVERSIONQ = 16,     // deactivateDiversionQ
  85. CDOT_INTERROGATEDIVERSIONQ = 17,    // interrogateDiversionQ
  86. CDOT_CHECKRESTRICTION = 18,         // checkRestriction
  87. CDOT_CALLREROUTING = 19,            // callRerouting
  88. CDOT_DIVERTINGLEGINFO1 = 20,        // divertingLegInformation1
  89. CDOT_DIVERTINGLEGINFO2 = 21,        // divertingLegInformation2
  90. CDOT_DIVERTINGLEGINFO3 = 22,        // divertingLegInformation3
  91. CDOT_DIVERTINGLEGINFO4 = 100,       // divertingLegInformation4
  92. CDOT_CFNRDIVLEGFAIL = 23            // cfnrDivertedLegFailed
  93. };
  97. /*
  98.  *  This defines the networkFacilityExtension field.
  99.  *  This is used in the H4501SupplementaryService ASN.1 sequence as
  100.  *  specified in H.450.1. This field is optional but when included, the
  101.  *  mandatory Set methods of this class must be used to properly create
  102.  *  this object.
  103.  *
  104.  * @See:
  105.  * - Used in H4501SuppService
  106.  */
  107. class DLLEXPORT H4501FacilityExt
  108. {
  109.     public:
  110. // Constructor
  111. H4501FacilityExt();
  112. H4501FacilityExt(H4501FacilityExt &);
  113. // Destructor
  114. ~H4501FacilityExt();
  116. // Mandatory - this sets the sourceEntity field.
  117. // @See:
  118. // - enum H4501EntityType
  119. ProtReturnCode SetSrcEntity(int);
  120. // Mandatory - this gets the sourceEntity field.
  121. // @See:
  122. // - enum H4501EntityType
  123. ProtReturnCode GetSrcEntity(int &);
  125. // Optional - this sets the sourceEntityAddress field.
  126. ProtReturnCode SetSrcEntityAddr(H450AliasAddress &);
  127. // Optional - this gets the sourceEntityAddress field.
  128. ProtReturnCode GetSrcEntityAddr(H450AliasAddress &);
  130. // Mandatory - this sets the destinationEntity field.
  131. // @See:
  132. // - enum H4501EntityType
  133. ProtReturnCode SetDstEntity(int);
  134. // Mandatory - this gets the destinationEntity field.
  135. // @See:
  136. // - enum H4501EntityType
  137. ProtReturnCode GetDstEntity(int &);
  139. // Optional - this sets the destinationEntityAddress field.
  140. ProtReturnCode SetDstEntityAddr(H450AliasAddress &);
  141. // Optional - this gets the destinationEntityAddress field.
  142. ProtReturnCode GetDstEntityAddr(H450AliasAddress &);
  144.         H4501FacilityExt & operator=(H4501FacilityExt &);
  146. // Determines if the class has been sufficiently created
  147.         boolean Valid();
  149. //@DELB
  150.         // For protocol internal use.
  152.         EmNetworkFacilityExtension *GetPriv();
  153.         ProtReturnCode SetPriv(EmNetworkFacilityExtension *);
  154. void SetValid();
  156. private:
  157. void Init();
  158. EmNetworkFacilityExtension *mExtPtr;
  159. int mIsValid;
  160. int mSrcFlag;
  161. int mDstFlag;
  162. //@DELE
  163. };
  167. /*
  168.  *  This is a virtual base class for the four types of ROS Operations.
  169.  *  Thse oprerations are Invoke, ReturnResult, ReturnError,
  170.  *  and Reject.
  171.  *  A ROS defines a single ServiceApdus field used in the
  172.  *  H4501SupplemtaryService ASN.1 sequence. The H4501SuppService class
  173.  *  manages a sequence of these objects.
  174.  *  @See:
  175.  * - H4501Invoke H4501ReturnResult H4501ReturnError H4501Reject
  176.  */
  177. class DLLEXPORT H4501ROS 
  178. {
  179.     public:
  180. // Constructor
  181. // @See:
  182. // - enum H4501ROSType
  183. H4501ROS(int);
  184. // Destructor
  185. virtual ~H4501ROS();
  188. // get type of ROS
  189. // @See:
  190. // - enum H4501ROSType
  191. int GetType();
  193. // Mandatory - this sets the invokeId field
  194. virtual ProtReturnCode SetInvokeId(int) = 0;
  195. // Mandatory - this gets the invokeId field
  196. virtual ProtReturnCode GetInvokeId(int &) = 0;
  198.         H4501ROS & operator=(H4501ROS &);
  200. // Determines if the class has been sufficiently created
  201.         virtual boolean Valid() = 0;
  203. //@DELB
  204. public:
  206.         // For protocol internal use.
  208.         virtual void *GetPriv() = 0;
  209.         virtual ProtReturnCode SetPriv(void *) = 0;
  211. struct CodeToNum
  212. {
  213. int Code;
  214. int ArgPDUNum;
  215. int ResPDUNum;
  216. int ArgType;
  217. int ResType;
  218. };
  220. protected:
  221. int GetArgPDUNum(int Code);
  222. int GetResPDUNum(int Code);
  223. int GetArgType(int Code);
  224. int GetResType(int Code);
  226. static CodeToNum MapTable[];
  228. private:
  229. int mType;
  231. //@DELE
  232. };
  236. /*
  237.  *  This defines the ROS Invoke APDU.
  238.  *
  239.  * @See:
  240.  * - Used in H4501SuppService
  241.  */
  242. class DLLEXPORT H4501Invoke : public H4501ROS
  243. {
  244.     public:
  245. // Constructor
  246. H4501Invoke();
  247. H4501Invoke(H4501Invoke &);
  248. // Destructor
  249. ~H4501Invoke();
  252. // Mandatory - this sets the invokeId field which is
  253. // a user supplied id that must be unambiguous.
  254. ProtReturnCode SetInvokeId(int);
  255. // Mandatory - this gets the invokeId field which is
  256. ProtReturnCode GetInvokeId(int &);
  258. // Mandatory - this sets the code field.
  259. // @Caveats:
  260. // <B>This field must be set before SetArgument is used.</B>
  261. ProtReturnCode SetCode(H4501Code &);
  262. // Mandatory - this gets the code field.
  263. ProtReturnCode GetCode(H4501Code &);
  265. // Optional - this sets the argument field.
  266. // @Caveats:
  267. // <B>The Code field must be set before the argument is set.</B>
  268. ProtReturnCode SetArgument(H450Arg &);
  269. // Optional - this gets the argument type.
  270. // @See:
  271. // - enum H450ArgumentType
  272. ProtReturnCode GetArgumentType(int &);
  273. // Optional - this gets the argument field.
  274. // @Caveats:
  275. // GetArgumentType should be called before GetArgument
  276. // in order to determine the argument received
  277. ProtReturnCode GetArgument(H450Arg &);
  279. // Optional - this sets the LinkedId field.
  280. ProtReturnCode SetLinkedId(int);
  281. // Optional - this gets the LinkedId field.
  282. ProtReturnCode GetLinkedId(int &);
  284. // Determines if the class has been sufficiently created
  285.         boolean Valid();
  287. //@DELB
  288.         // For protocol internal use.
  289.         void *GetPriv();
  290.         ProtReturnCode SetPriv(void *);
  291. void SetValid();
  293. private:
  294. void Init();
  295. boolean AllocArg(int Type, void **ppDst);
  296. boolean FreeArg(int Type, void *pDst);
  297. boolean InitArg(int Type, void *pDst);
  298. boolean CopyArg(int Type, void *pSrc, void *pDst);
  300. EmROS *mRosPtr;
  301. int mIsValid;
  302. int mCodeSet;
  303. int mIdSet;
  304. ASN1Codec *mCodecObjPtr;
  305. void *mArgStructPtr;
  306. int mArgType; 
  308. void *mEncodedArgPtr;
  310. //@DELE
  311. };
  315. /*
  316.  *  This defines the ROS ReturnResult APDU.
  317.  *
  318.  * @See:
  319.  * - Used in H4501SuppService
  320.  */
  321. class DLLEXPORT H4501ReturnResult : public H4501ROS
  322. {
  323.     public:
  324. // Constructor
  325. H4501ReturnResult();
  326. H4501ReturnResult(H4501ReturnResult &);
  327. // Destructor
  328. ~H4501ReturnResult();
  331. // Mandatory - this sets the invokeId field. 
  332. ProtReturnCode SetInvokeId(int);
  333. // Mandatory - this gets the invokeId field. 
  334. ProtReturnCode GetInvokeId(int &);
  336. // Optional - this sets the result field.
  337. ProtReturnCode SetResult(H4501Code &, H450Res &);
  338. // Optional - this gets the result type.
  339. // @See:
  340. // - enum H450ResultType
  341. ProtReturnCode GetResultType(int &);
  342. // Optional - this gets the result field.
  343. // @Caveats:
  344. // GetResultType should be called before GetResult
  345. // in order to determine the result received
  346. ProtReturnCode GetResult(H4501Code &, H450Res &);
  348. // Determines if the class has been sufficiently created
  349.         boolean Valid();
  351. //@DELB
  352.         // For protocol internal use.
  354.         void *GetPriv();
  355.         ProtReturnCode SetPriv(void *);
  356. void SetValid();
  358. private:
  359. void Init();
  360. boolean AllocRes(int Type, void **ppDst);
  361. boolean FreeRes(int Type, void *pDst);
  362. boolean InitRes(int Type, void *pDst);
  363. boolean CopyRes(int Type, void *pSrc, void *pDst);
  365. EmROS *mRosPtr;
  366. int mIsValid;
  367. ASN1Codec *mCodecObjPtr;
  368. void *mResStructPtr;
  369. int mResType; 
  371. void *mEncodedResPtr;
  373. //@DELE
  374. };
  378. /*
  379.  *  This defines the ROS ReturnError APDU.
  380.  *
  381.  * @See:
  382.  * - Used in H4501SuppService
  383.  */
  384. class DLLEXPORT H4501ReturnError : public H4501ROS
  385. {
  386.     public:
  387. // Constructor
  388. H4501ReturnError();
  389. H4501ReturnError(H4501ReturnError &);
  390. // Destructor
  391. ~H4501ReturnError();
  394. // Mandatory - this sets the invokeId field.
  395. ProtReturnCode SetInvokeId(int);
  396. // Mandatory - this gets the invokeId field.
  397. ProtReturnCode GetInvokeId(int &);
  400. // Mandatory - this sets the errcode field.
  401. ProtReturnCode SetCode(H4501Code &);
  402. // Mandatory - this gets the errcode field.
  403. ProtReturnCode GetCode(H4501Code &);
  405. // Optional - this sets the parameter field.
  406. ProtReturnCode SetError(H450Error &);
  407. // Optional - this gets the parameter field.
  408. ProtReturnCode GetError(H450Error &);
  410. // Determines if the class has been sufficiently created
  411.         boolean Valid();
  413. //@DELB
  414.         // For protocol internal use.
  416.         void *GetPriv();
  417.         ProtReturnCode SetPriv(void *);
  418. void SetValid();
  420. private:
  421. void Init();
  422. EmROS *mRosPtr;
  423. int mIsValid;
  424. int mCodeSet;
  425. int mIdSet;
  426. ASN1Codec *mCodecObjPtr;
  427. void *mErrStructPtr;
  428. int mParamType;
  430. void *mEncodedErrPtr;
  432. //@DELE
  433. };
  437. /*
  438.  *  This defines the ROS Reject APDU.
  439.  *
  440.  * @See:
  441.  * - Used in H4501SuppService
  442.  */
  443. class DLLEXPORT H4501Reject : public H4501ROS
  444. {
  445.     public:
  446. // Constructor
  447. H4501Reject();
  448. H4501Reject(H4501Reject &);
  449. // Destructor
  450. ~H4501Reject();
  453. // Mandatory - this sets the invokeId field. 
  454. ProtReturnCode SetInvokeId(int);
  455. // Mandatory - this gets the invokeId field. 
  456. ProtReturnCode GetInvokeId(int &);
  458. // Mandatory - this sets the problem field
  459. ProtReturnCode SetProblem(H4501Problem &);
  460. // Mandatory - this gets the problem field
  461. ProtReturnCode GetProblem(H4501Problem &);
  463. // Determines if the class has been sufficiently created
  464.         boolean Valid();
  466. //@DELB
  467.         // For protocol internal use.
  469.         void *GetPriv();
  470.         ProtReturnCode SetPriv(void *);
  471. void SetValid();
  473. private:
  474. void Init();
  475. EmROS *mRosPtr;
  476. int mIsValid;
  477. int mProbSet;
  478. int mIdSet;
  480. //@DELE
  481. };
  485. /*
  486.  *  This is for the H4501SupplementaryService ASN.1 sequence.
  487.  *  It is the top level class used to implement supplemnetary services.
  488.  */
  489. class DLLEXPORT H4501SuppService
  490. {
  491.     public:
  492. // Constructor
  493. H4501SuppService();
  494. H4501SuppService(H4501SuppService &);
  495. // Destructor
  496. ~H4501SuppService();
  499. // Optional - this sets the networkFacilityExtension field.
  500. ProtReturnCode SetNetFacExt(H4501FacilityExt &);
  501. // Optional - this gets the networkFacilityExtension field.
  502. ProtReturnCode GetNetFacExt(H4501FacilityExt &);
  504. // Optional - this sets the interpretationApdu ASN.1 CHOICE
  505. // @See:
  506. // - enum H4501InterpretationAPDU
  507. ProtReturnCode SetInterpAPDU(int);
  508. // Optional - this gets the interpretationApdu ASN.1 CHOICE
  509. // @See:
  510. // - enum H4501InterpretationAPDU
  511. ProtReturnCode GetInterpAPDU(int &);
  513. // Mandatory - this adds a ROS the serviceApdu field. 
  514. ProtReturnCode AddROS(H4501ROS &);
  515. // Mandatory - this gets a ROS from the serviceApdu field. 
  516. // The index and ros type should match the index and
  517. // ROS type received in the list from GetROSTypes()
  518. //
  519. // @Caveats:
  520. // To get the ROS[s] from this class the following sequence
  521. // should be followed:
  522. // <OL>
  523. // <LI>  Use GetNumROSs() so that an int array of sufficient
  524. //       length can be allocated for the ROS types list.
  525. // <LI>  Use GetROSTypes() to get the ROS types list.
  526. // <LI>  Call GetROS() for each entry in the ROS types list
  527. //       with the appropriate instance of ROS
  528. // </OL>
  529. ProtReturnCode GetROS(int index, H4501ROS &ros);
  530. // Mandatory - this gets the number of ROSs in serviceApdu field. 
  531. // See GetROS for sequence of calls to get ROSs
  532. ProtReturnCode GetNumROSs(int &count);
  533. // Mandatory - this gets the types of ROSs in serviceApdu field. 
  534. // See GetROS for sequence of calls to get ROSs
  535. ProtReturnCode GetROSTypes(int types[], int &count);
  537. // Determines if the class has been sufficiently created
  538.         boolean Valid();
  540.         H4501SuppService & operator=(H4501SuppService &);
  542. //@DELB
  543.         // For protocol internal use.
  545.         EmH4501SupplementaryService *GetPriv();
  546.         ProtReturnCode SetPriv(EmH4501SupplementaryService *);
  547.         ProtReturnCode GetASN1Msg(unsigned int *length, unsigned char **);
  548.         ProtReturnCode SetASN1Msg(unsigned int length, unsigned char *);
  550. private:
  551. void Init();
  552. ASN1Codec *mCodecObjPtr;
  553. void *mEncodedMsgPtr;
  554. EmH4501SupplementaryService *mSupServPtr;
  555. int mIsValid;
  557. //@DELE
  558. };
  562. //@DELB
  563. #endif  // __H4501SUPPSERV_H__
  564. //@DELE