h323ep.h

Go to the documentation of this file.

/*
 * h323ep.h
 *
 * H.323 protocol handler
 *
 * Open H323 Library
 *
 * Copyright (c) 1998-2001 Equivalence Pty. Ltd.
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Open H323 Library.
 *
 * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
 *
 * Portions of this code were written with the assisance of funding from
 * Vovida Networks, Inc. http://www.vovida.com.
 *
 * Contributor(s): ______________________________________.
 *
 * $Log: h323ep.h,v $
 * Revision 2.50  2007/06/29 06:59:56  rjongbloed
 * Major improvement to the "product info", normalising H.221 and User-Agent mechanisms.
 *
 * Revision 2.49  2007/05/15 07:26:38  csoutheren
 * Remove deprecated  interface to STUN server in H323Endpoint
 * Change UseNATForIncomingCall to IsRTPNATEnabled
 * Various cleanups of messy and unused code
 *
 * Revision 2.48  2007/03/13 00:32:16  csoutheren
 * Simple but messy changes to allow compile time removal of protocol
 * options such as H.450 and H.460
 * Fix MakeConnection overrides
 *
 * Revision 2.47  2007/03/01 05:51:03  rjongbloed
 * Fixed backward compatibility of OnIncomingConnection() virtual
 *   functions on various classes. If an old override returned FALSE
 *   then it will now abort the call as it used to.
 *
 * Revision 2.46  2007/01/24 04:00:55  csoutheren
 * Arrrghh. Changing OnIncomingConnection turned out to have a lot of side-effects
 * Added some pure viritual functions to prevent old code from breaking silently
 * New OpalEndpoint and OpalConnection descendants will need to re-implement
 * OnIncomingConnection. Sorry :)
 *
 * Revision 2.45  2007/01/18 12:49:21  csoutheren
 * Add ability to disable T.38 in compile
 *
 * Revision 2.44  2007/01/18 04:45:16  csoutheren
 * Messy, but simple change to add additional options argument to OpalConnection constructor
 * This allows the provision of non-trivial arguments for connections
 *
 * Revision 2.43  2006/12/18 03:18:41  csoutheren
 * Messy but simple fixes
 *   - Add access to SIP REGISTER timeout
 *   - Ensure OpalConnection options are correctly progagated
 *
 * Revision 2.42  2006/12/13 05:01:21  csoutheren
 * Applied 1613992 - fixes a feature set memory leak
 * Thanks to Drazen Dimoti
 *
 * Revision 2.41  2006/08/29 01:37:11  csoutheren
 * Change secure URLs to use h323s and tcps to be inline with sips
 *
 * Revision 2.40  2006/08/21 05:29:25  csoutheren
 * Messy but relatively simple change to add support for secure (SSL/TLS) TCP transport
 * and secure H.323 signalling via the sh323 URL scheme
 *
 * Revision 2.39  2006/06/27 13:07:37  csoutheren
 * Patch 1374533 - add h323 Progress handling
 * Thanks to Frederich Heem
 *
 * Revision 2.38  2006/06/27 12:54:35  csoutheren
 * Patch 1374489 - h450.7 message center support
 * Thanks to Frederich Heem
 *
 * Revision 2.37  2006/05/30 11:33:02  hfriederich
 * Porting support for H.460 from OpenH323
 *
 * Revision 2.36  2006/05/30 04:58:05  csoutheren
 * Added suport for SIP INFO message (untested as yet)
 * Fixed some issues with SIP state machine on answering calls
 * Fixed some formatting issues
 *
 * Revision 2.35  2006/04/20 16:52:22  hfriederich
 * Adding support for H.224/H.281
 *
 * Revision 2.34  2006/03/07 11:23:46  csoutheren
 * Add ability to disable GRQ on GK registration
 *
 * Revision 2.33  2006/02/22 10:40:09  csoutheren
 * Added patch #1374583 from Frederic Heem
 * Added additional H.323 virtual function
 *
 * Revision 2.32  2006/02/22 10:29:09  csoutheren
 * Applied patch #1374470 from Frederic Heem
 * Add ability to disable H.245 negotiation
 *
 * Revision 2.31  2006/01/02 15:52:38  dsandras
 * Added what was required to merge changes from OpenH323 Altas_devel_2 in gkclient.cxx, gkserver.cxx and channels.cxx.
 *
 * Revision 2.30  2005/11/30 13:35:26  csoutheren
 * Changed tags for Doxygen
 *
 * Revision 2.29  2005/07/12 12:34:37  csoutheren
 * Fixes for H.450 errors and return values
 * Thanks to Iker Perez San Roman
 *
 * Revision 2.28  2005/07/11 01:52:23  csoutheren
 * Extended AnsweringCall to work for SIP as well as H.323
 * Fixed problems with external RTP connection in H.323
 * Added call to OnClosedMediaStream
 *
 * Revision 2.27  2004/09/01 12:21:27  rjongbloed
 * Added initialisation of H323EndPoints capability table to be all codecs so can
 *   correctly build remote caps from fqast connect params. This had knock on effect
 *   with const keywords added in numerous places.
 *
 * Revision 2.26  2004/08/14 07:56:28  rjongbloed
 * Major revision to utilise the PSafeCollection classes for the connections and calls.
 *
 * Revision 2.25  2004/07/11 12:42:09  rjongbloed
 * Added function on endpoints to get the list of all media formats any
 *   connection the endpoint may create can support.
 *
 * Revision 2.24  2004/06/05 14:31:32  rjongbloed
 * Added function to set gatekeeper registration time to live.
 * Added ability to have separate gatekeeper username to endpoint local alias name.
 *
 * Revision 2.23  2004/06/04 06:54:17  csoutheren
 * Migrated updates from OpenH323 1.14.1
 *
 * Revision 2.22  2004/02/24 09:40:27  rjongbloed
 * Fixed missing return in GetSTUN()
 *
 * Revision 2.21  2004/02/19 10:46:44  rjongbloed
 * Merged OpenH323 version 1.13.1 changes.
 *
 * Revision 2.20  2003/03/06 03:57:46  robertj
 * IVR support (work in progress) requiring large changes everywhere.
 *
 * Revision 2.19  2003/01/07 04:39:52  robertj
 * Updated to OpenH323 v1.11.2
 *
 * Revision 2.18  2002/11/10 11:33:16  robertj
 * Updated to OpenH323 v1.10.3
 *
 * Revision 2.17  2002/09/16 02:52:33  robertj
 * Added #define so can select if #pragma interface/implementation is used on
 *   platform basis (eg MacOS) rather than compiler, thanks Robert Monaghan.
 *
 * Revision 2.16  2002/09/10 07:42:40  robertj
 * Added function to get gatekeeper password.
 *
 * Revision 2.15  2002/09/06 02:39:27  robertj
 * Added function to set gatekeeper access token OID.
 *
 * Revision 2.14  2002/09/04 06:01:46  robertj
 * Updated to OpenH323 v1.9.6
 *
 * Revision 2.13  2002/07/04 07:41:46  robertj
 * Fixed memory/thread leak of transports.
 *
 * Revision 2.12  2002/07/01 04:56:29  robertj
 * Updated to OpenH323 v1.9.1
 *
 * Revision 2.11  2002/03/22 06:57:48  robertj
 * Updated to OpenH323 version 1.8.2
 *
 * Revision 2.10  2002/03/18 00:33:36  robertj
 * Removed duplicate initialBandwidth variable in H.323 class, moved to ancestor.
 *
 * Revision 2.9  2002/02/11 09:32:11  robertj
 * Updated to openH323 v1.8.0
 *
 * Revision 2.8  2002/01/22 04:59:04  robertj
 * Update from OpenH323, RFC2833 support
 *
 * Revision 2.7  2002/01/14 06:35:57  robertj
 * Updated to OpenH323 v1.7.9
 *
 * Revision 2.6  2001/11/13 06:25:56  robertj
 * Changed SetUpConnection() so returns BOOL as returning
 *   pointer to connection is not useful.
 *
 * Revision 2.5  2001/11/02 10:45:19  robertj
 * Updated to OpenH323 v1.7.3
 *
 * Revision 2.4  2001/10/05 00:22:13  robertj
 * Updated to PWLib 1.2.0 and OpenH323 1.7.0
 *
 * Revision 2.3  2001/08/17 08:21:15  robertj
 * Update from OpenH323
 * Moved call end reasons enum from OpalConnection to global.
 *
 * Revision 2.2  2001/08/01 05:10:40  robertj
 * Moved media formats list from endpoint to connection.
 *
 * Revision 2.1  2001/07/30 07:22:25  robertj
 * Abstracted listener management from H.323 to OpalEndPoint class.
 *
 * Revision 2.0  2001/07/27 15:48:24  robertj
 * Conversion of OpenH323 to Open Phone Abstraction Library (OPAL)
 *
 * Revision 1.56  2003/12/29 04:58:55  csoutheren
 * Added callbacks on H323EndPoint when gatekeeper discovery succeeds or fails
 *
 * Revision 1.55  2003/12/28 02:52:15  csoutheren
 * Added virtual to a few functions
 *
 * Revision 1.54  2003/12/28 02:38:14  csoutheren
 * Added H323EndPoint::OnOutgoingCall
 *
 * Revision 1.53  2003/12/28 00:07:10  csoutheren
 * Added callbacks on H323EndPoint when gatekeeper registration succeeds or fails
 *
 * Revision 1.52  2003/04/24 01:49:33  dereks
 * Add ability to set no media timeout interval
 *
 * Revision 1.51  2003/04/10 09:39:48  robertj
 * Added associated transport to new GetInterfaceAddresses() function so
 *   interfaces can be ordered according to active transport links. Improves
 *   interoperability.
 *
 * Revision 1.50  2003/04/10 01:05:11  craigs
 * Added functions to access to lists of interfaces
 *
 * Revision 1.49  2003/04/07 13:09:25  robertj
 * Added ILS support to callto URL parsing in MakeCall(), ie can now call hosts
 *   registered with an ILS directory.
 *
 * Revision 1.48  2003/02/13 00:11:31  robertj
 * Added missing virtual for controlling call transfer, thanks Andrey Pinaev
 *
 * Revision 1.47  2003/02/09 00:48:06  robertj
 * Added function to return if registered with gatekeeper.
 *
 * Revision 1.46  2003/02/04 07:06:41  robertj
 * Added STUN support.
 *
 * Revision 1.45  2003/01/26 05:57:58  robertj
 * Changed ParsePartyName so will accept addresses of the form
 *   alias@gk:address which will do an LRQ call to "address" using "alias"
 *   to determine the IP address to connect to.
 *
 * Revision 1.44  2003/01/23 02:36:30  robertj
 * Increased (and made configurable) timeout for H.245 channel TCP connection.
 *
 * Revision 1.43  2002/11/28 01:19:55  craigs
 * Added virtual to several functions
 *
 * Revision 1.42  2002/11/27 06:54:52  robertj
 * Added Service Control Session management as per Annex K/H.323 via RAS
 *   only at this stage.
 * Added H.248 ASN and very primitive infrastructure for linking into the
 *   Service Control Session management system.
 * Added basic infrastructure for Annex K/H.323 HTTP transport system.
 * Added Call Credit Service Control to display account balances.
 *
 * Revision 1.41  2002/11/15 05:17:22  robertj
 * Added facility redirect support without changing the call token for access
 *   to the call. If it gets redirected a new H323Connection object is
 *   created but it looks like the same thing to an application.
 *
 * Revision 1.40  2002/11/10 08:10:43  robertj
 * Moved constants for "well known" ports to better place (OPAL change).
 *
 * Revision 1.39  2002/10/31 00:32:15  robertj
 * Enhanced jitter buffer system so operates dynamically between minimum and
 *   maximum values. Altered API to assure app writers note the change!
 *
 * Revision 1.38  2002/10/23 06:06:10  robertj
 * Added function to be smarter in using a gatekeeper for use by endpoint.
 *
 * Revision 1.37  2002/10/21 06:07:44  robertj
 * Added function to set gatekeeper access token OID.
 *
 * Revision 1.36  2002/09/16 01:14:15  robertj
 * Added #define so can select if #pragma interface/implementation is used on
 *   platform basis (eg MacOS) rather than compiler, thanks Robert Monaghan.
 *
 * Revision 1.35  2002/09/10 06:32:25  robertj
 * Added function to get gatekeeper password.
 *
 * Revision 1.34  2002/09/03 06:19:36  robertj
 * Normalised the multi-include header prevention ifdef/define symbol.
 *
 * Revision 1.33  2002/07/19 03:39:19  robertj
 * Bullet proofed setting of RTP IP port base, can't be zero!
 *
 * Revision 1.32  2002/07/18 01:50:10  robertj
 * Changed port secltion code to force apps to use function interface.
 *
 * Revision 1.31  2002/06/22 05:48:38  robertj
 * Added partial implementation for H.450.11 Call Intrusion
 *
 * Revision 1.30  2002/06/13 06:15:19  robertj
 * Allowed TransferCall() to be used on H323Connection as well as H323EndPoint.
 *
 * Revision 1.29  2002/06/12 03:55:21  robertj
 * Added function to add/remove multiple listeners in one go comparing against
 *   what is already running so does not interrupt unchanged listeners.
 *
 * Revision 1.28  2002/05/29 06:40:29  robertj
 * Changed sending of endSession/ReleaseComplete PDU's to occur immediately
 *   on call clearance and not wait for background thread to do it.
 * Stricter compliance by waiting for reply endSession before closing down.
 *
 * Revision 1.27  2002/05/28 06:15:09  robertj
 * Split UDP (for RAS) from RTP port bases.
 * Added current port variable so cycles around the port range specified which
 *   fixes some wierd problems on some platforms, thanks Federico Pinna
 *
 * Revision 1.26  2002/05/17 03:38:05  robertj
 * Fixed problems with H.235 authentication on RAS for server and client.
 *
 * Revision 1.25  2002/05/16 00:03:05  robertj
 * Added function to get the tokens for all active calls.
 * Improved documentation for use of T.38 and T.120 functions.
 *
 * Revision 1.24  2002/05/15 08:59:18  rogerh
 * Update comments
 *
 * Revision 1.23  2002/05/03 05:38:15  robertj
 * Added Q.931 Keypad IE mechanism for user indications (DTMF).
 *
 * Revision 1.22  2002/05/02 07:56:24  robertj
 * Added automatic clearing of call if no media (RTP data) is transferred in a
 *   configurable (default 5 minutes) amount of time.
 *
 * Revision 1.21  2002/04/18 01:41:07  robertj
 * Fixed bad variable name for disabling DTMF detection, very confusing.
 *
 * Revision 1.20  2002/04/17 00:49:56  robertj
 * Added ability to disable the in band DTMF detection.
 *
 * Revision 1.19  2002/04/10 06:48:47  robertj
 * Added functions to set port member variables.
 *
 * Revision 1.18  2002/03/14 03:49:38  dereks
 * Fix minor documentation error.
 *
 * Revision 1.17  2002/02/04 07:17:52  robertj
 * Added H.450.2 Consultation Transfer, thanks Norwood Systems.
 *
 * Revision 1.16  2002/01/24 06:29:02  robertj
 * Added option to disable H.245 negotiation in SETUP pdu, this required
 *   API change so have a bit mask instead of a series of booleans.
 *
 * Revision 1.15  2002/01/17 07:04:58  robertj
 * Added support for RFC2833 embedded DTMF in the RTP stream.
 *
 * Revision 1.14  2002/01/13 23:59:43  robertj
 * Added CallTransfer timeouts to endpoint, hanks Ben Madsen of Norwood Systems.
 *
 * Revision 1.13  2002/01/08 04:45:35  robertj
 * Added MakeCallLocked() so can start a call with the H323Connection instance
 *   initally locked so can do things to it before the call really starts.
 *
 * Revision 1.12  2001/12/22 03:20:44  robertj
 * Added create protocol function to H323Connection.
 *
 * Revision 1.11  2001/12/13 10:55:30  robertj
 * Added gatekeeper access token OID specification for auto inclusion of
 *   access tokens frm ACF to SETUP pdu.
 *
 * Revision 1.10  2001/11/09 05:39:54  craigs
 * Added initial T.38 support thanks to Adam Lazur
 *
 * Revision 1.9  2001/11/01 00:27:33  robertj
 * Added default Fast Start disabled and H.245 tunneling disable flags
 *   to the endpoint instance.
 *
 * Revision 1.8  2001/09/11 01:24:36  robertj
 * Added conditional compilation to remove video and/or audio codecs.
 *
 * Revision 1.7  2001/09/11 00:21:21  robertj
 * Fixed missing stack sizes in endpoint for cleaner thread and jitter thread.
 *
 * Revision 1.6  2001/08/24 14:03:26  rogerh
 * Fix some spelling mistakes
 *
 * Revision 1.5  2001/08/16 07:49:16  robertj
 * Changed the H.450 support to be more extensible. Protocol handlers
 *   are now in separate classes instead of all in H323Connection.
 *
 * Revision 1.4  2001/08/10 11:03:49  robertj
 * Major changes to H.235 support in RAS to support server.
 *
 * Revision 1.3  2001/08/08 23:54:11  robertj
 * Fixed problem with setting gk password before have a gk variable.
 *
 * Revision 1.2  2001/08/06 03:15:17  robertj
 * Improved access to H.235 secure RAS functionality.
 *
 * Revision 1.1  2001/08/06 03:08:11  robertj
 * Fission of h323.h to h323ep.h & h323con.h, h323.h now just includes files.
 */

#ifndef __OPAL_H323EP_H
#define __OPAL_H323EP_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif


#include <opal/endpoint.h>
#include <opal/manager.h>
#include <opal/call.h>
#include <opal/transports.h>
#include <h323/h323con.h>
#include <h323/h323caps.h>
#include <h323/h235auth.h>

#ifdef H323_H460
#include <h323/h4601.h>
#endif


class H225_EndpointType;
class H225_VendorIdentifier;
class H225_H221NonStandard;
class H225_ServiceControlDescriptor;
class H225_FeatureSet;

class H235SecurityInfo;

class H323Gatekeeper;
class H323SignalPDU;
class H323ServiceControlSession;


class H323EndPoint : public OpalEndPoint
{
  PCLASSINFO(H323EndPoint, OpalEndPoint);

  public:
    enum {
      DefaultTcpSignalPort = 1720
    };

    H323EndPoint(
      OpalManager & manager,
      const char * prefix = "h323",
      WORD defaultSignalPort = DefaultTcpSignalPort
    );

    ~H323EndPoint();

    virtual BOOL MakeConnection(
      OpalCall & call,                  
      const PString & party,            
      void * userData  = NULL,          
      unsigned int options = NULL,      
      OpalConnection::StringOptions * stringOptions = NULL
    );

    virtual OpalMediaFormatList GetMediaFormats() const;

    virtual void SetEndpointTypeInfo(
      H225_EndpointType & info
    ) const;

    virtual void SetVendorIdentifierInfo(
      H225_VendorIdentifier & info
    ) const;

    virtual void SetH221NonStandardInfo(
      H225_H221NonStandard & info
    ) const;


    void AddCapability(
      H323Capability * capability   
    );

    PINDEX SetCapability(
      PINDEX descriptorNum, 
      PINDEX simultaneous,  
      H323Capability * cap  
    );

    PINDEX AddAllCapabilities(
      PINDEX descriptorNum, 
      PINDEX simultaneous,  
      const PString & name  
    );

    void AddAllUserInputCapabilities(
      PINDEX descriptorNum, 
      PINDEX simultaneous   
    );

    void RemoveCapabilities(
      const PStringArray & codecNames
    );

    void ReorderCapabilities(
      const PStringArray & preferenceOrder
    );

    H323Capability * FindCapability(
      const H245_Capability & cap  
    ) const;

    H323Capability * FindCapability(
      const H245_DataType & dataType  
    ) const;

    H323Capability * FindCapability(
      H323Capability::MainTypes mainType,   
      unsigned subType                      
    ) const;

    BOOL UseGatekeeper(
      const PString & address = PString::Empty(),     
      const PString & identifier = PString::Empty(),  
      const PString & localAddress = PString::Empty() 
    );

    BOOL SetGatekeeper(
      const PString & address,          
      H323Transport * transport = NULL  
    );

    BOOL SetGatekeeperZone(
      const PString & address,          
      const PString & identifier,       
      H323Transport * transport = NULL  
    );

    BOOL LocateGatekeeper(
      const PString & identifier,       
      H323Transport * transport = NULL  
    );

    BOOL DiscoverGatekeeper(
      H323Transport * transport = NULL  
    );

    virtual H323Gatekeeper * CreateGatekeeper(
      H323Transport * transport  
    );

    H323Gatekeeper * GetGatekeeper() const { return gatekeeper; }

    BOOL IsRegisteredWithGatekeeper() const;

    BOOL RemoveGatekeeper(
      int reason = -1    
    );

    virtual void SetGatekeeperPassword(
      const PString & password,
      const PString & username = PString::Empty()
    );

    virtual const PString & GetGatekeeperUsername() const { return gatekeeperUsername; }

    virtual const PString & GetGatekeeperPassword() const { return gatekeeperPassword; }

    virtual H235Authenticators CreateAuthenticators();

    virtual void  OnGatekeeperConfirm();

    virtual void  OnGatekeeperReject();

    virtual void OnRegistrationConfirm();

    virtual void  OnRegistrationReject();

    virtual BOOL NewIncomingConnection(
      OpalTransport * transport  
    );

    virtual H323Connection * CreateConnection(
      OpalCall & call,                         
      const PString & token,                   
      void * userData,                         
      OpalTransport & transport,               
      const PString & alias,                   
      const H323TransportAddress & address,    
      H323SignalPDU * setupPDU,                
      unsigned options = 0,
      OpalConnection::StringOptions * stringOptions = NULL 
    );

    virtual BOOL SetupTransfer(
      const PString & token,        
      const PString & callIdentity, 
      const PString & remoteParty,  
      void * userData = NULL        
    );

    void TransferCall(
      const PString & token,        
      const PString & remoteParty,  
      const PString & callIdentity = PString::Empty()
    );

    void ConsultationTransfer(
      const PString & primaryCallToken,   
      const PString & secondaryCallToken  
    );

    void HoldCall(
      const PString & token,        
      BOOL localHold   
    );

    BOOL IntrudeCall(
      const PString & remoteParty,  
      unsigned capabilityLevel,     
      void * userData = NULL        
    );

    BOOL ParsePartyName(
      const PString & party,          
      PString & alias,                
      H323TransportAddress & address  
    );

    PSafePtr<H323Connection> FindConnectionWithLock(
      const PString & token,     
      PSafetyMode mode = PSafeReadWrite
    );

    virtual BOOL OnSendSignalSetup(H323Connection & connection,
                                   H323SignalPDU & setupPDU);

    virtual BOOL OnSendCallProceeding(H323Connection & connection,
                                      H323SignalPDU & callProceedingPDU
                                     );
    
    virtual BOOL OnSendConnect(H323Connection & connection,
                               H323SignalPDU & connectPDU
                              );
    
    virtual BOOL OnIncomingCall(
      H323Connection & connection,    
      const H323SignalPDU & setupPDU,   
      H323SignalPDU & alertingPDU       
    );

    virtual BOOL OnOutgoingCall(
        H323Connection & conn, 
        const H323SignalPDU & connectPDU
    );

    virtual BOOL OnCallTransferInitiate(
      H323Connection & connection,    
      const PString & remoteParty     
    );

    virtual BOOL OnCallTransferIdentify(
      H323Connection & connection    
    );

    virtual void OnSendARQ(
      H323Connection & conn,
      H225_AdmissionRequest & arq
    );

    virtual OpalConnection::AnswerCallResponse OnAnswerCall(
      H323Connection & connection,    
      const PString & callerName,       
      const H323SignalPDU & setupPDU,   
      H323SignalPDU & connectPDU,       
      H323SignalPDU & progressPDU        
    );
    virtual OpalConnection::AnswerCallResponse OnAnswerCall(
       OpalConnection & connection,
       const PString & caller
    );

    virtual BOOL OnAlerting(
      H323Connection & connection,    
      const H323SignalPDU & alertingPDU,  
      const PString & user                
    );

    virtual BOOL OnSendAlerting(H323Connection & connection,  
                                H323SignalPDU & alerting,     
                                const PString & calleeName,   
                                BOOL withMedia                
                               );
        
    virtual BOOL OnSentAlerting(H323Connection & connection);
    
    virtual BOOL OnConnectionForwarded(
      H323Connection & connection,    
      const PString & forwardParty,   
      const H323SignalPDU & pdu       
    );

    virtual BOOL ForwardConnection(
      H323Connection & connection,    
      const PString & forwardParty,   
      const H323SignalPDU & pdu       
    );

    virtual void OnConnectionEstablished(
      H323Connection & connection,    
      const PString & token           
    );

    virtual BOOL IsConnectionEstablished(
      const PString & token   
    );

    virtual void OnConnectionCleared(
      H323Connection & connection,    
      const PString & token           
    );


    virtual BOOL OnStartLogicalChannel(
      H323Connection & connection,    
      H323Channel & channel           
    );

    virtual void OnClosedLogicalChannel(
      H323Connection & connection,    
      const H323Channel & channel     
    );

    virtual void OnRTPStatistics(
      const H323Connection & connection,  
      const RTP_Session & session         
    ) const;

    virtual void OnGatekeeperNATDetect(
      PIPSocket::Address publicAddr,         
      PString & gkIdentifier,                
      H323TransportAddress & gkRouteAddress  
    );

    virtual void OnHTTPServiceControl(
      unsigned operation,  
      unsigned sessionId,  
      const PString & url  
    );

    virtual void OnCallCreditServiceControl(
      const PString & amount,  
      BOOL mode          
    );

    virtual void OnServiceControlSession(
      unsigned type,
      unsigned sessionid,
      const H323ServiceControlSession & session,
      H323Connection * connection
    );

    virtual H323ServiceControlSession * CreateServiceControlSession(
      const H225_ServiceControlDescriptor & contents
    );

    virtual BOOL OnConferenceInvite(
      const H323SignalPDU & setupPDU
    );

    virtual BOOL OnCallIndependentSupplementaryService(
      const H323SignalPDU & setupPDU
    );

    virtual BOOL OnNegotiateConferenceCapabilities(
      const H323SignalPDU & setupPDU
    );

    virtual void SetLocalUserName(
      const PString & name  
    );

    virtual const PString & GetLocalUserName() const { return localAliasNames[0]; }

    BOOL AddAliasName(
      const PString & name  
    );

    BOOL RemoveAliasName(
      const PString & name  
    );

    const PStringList & GetAliasNames() const { return localAliasNames; }

    const PString & GetDefaultILSServer() const { return manager.GetDefaultILSServer(); }

    void SetDefaultILSServer(
      const PString & server
    ) { manager.SetDefaultILSServer(server); }

    BOOL IsFastStartDisabled() const
      { return disableFastStart; }

    void DisableFastStart(
      BOOL mode 
    ) { disableFastStart = mode; } 

    BOOL IsH245TunnelingDisabled() const
      { return disableH245Tunneling; }

    void DisableH245Tunneling(
      BOOL mode 
    ) { disableH245Tunneling = mode; } 

    BOOL IsH245inSetupDisabled() const
      { return disableH245inSetup; }

    void DisableH245inSetup(
      BOOL mode 
    ) { disableH245inSetup = mode; } 

    BOOL IsH245Disabled() const
    { return m_bH245Disabled; }

    void DisableH245(BOOL bH245Disabled) { m_bH245Disabled = bH245Disabled; } 
    
    BOOL CanDisplayAmountString() const
      { return canDisplayAmountString; }

    void SetCanDisplayAmountString(
      BOOL mode 
    ) { canDisplayAmountString = mode; } 

    BOOL CanEnforceDurationLimit() const
      { return canEnforceDurationLimit; }

    void SetCanEnforceDurationLimit(
      BOOL mode 
    ) { canEnforceDurationLimit = mode; } 

#if OPAL_H450

    unsigned GetCallIntrusionProtectionLevel() const { return callIntrusionProtectionLevel; }

    void SetCallIntrusionProtectionLevel(
      unsigned level  
    ) { PAssert(level<=3, PInvalidParameter); callIntrusionProtectionLevel = level; }
#endif

    virtual void OnReceivedInitiateReturnError();

#if OPAL_VIDEO

    BOOL CanAutoStartReceiveVideo() const { return manager.CanAutoStartReceiveVideo(); }

    BOOL CanAutoStartTransmitVideo() const { return manager.CanAutoStartTransmitVideo(); }
#endif

#if OPAL_T38FAX

    BOOL CanAutoStartReceiveFax() const { return autoStartReceiveFax; }

    BOOL CanAutoStartTransmitFax() const { return autoStartTransmitFax; }
#endif

    BOOL IsH224Enabled() const { return isH224Enabled; }
        
    void SetIsH224Enabled(BOOL flag) { isH224Enabled = flag; }

    BOOL CanAutoCallForward() const { return autoCallForward; }

    const H323Capabilities & GetCapabilities() const;

    enum TerminalTypes {
      e_TerminalOnly = 50,
      e_TerminalAndMC = 70,
      e_GatewayOnly = 60,
      e_GatewayAndMC = 80,
      e_GatewayAndMCWithDataMP = 90,
      e_GatewayAndMCWithAudioMP = 100,
      e_GatewayAndMCWithAVMP = 110,
      e_GatekeeperOnly = 120,
      e_GatekeeperWithDataMP = 130,
      e_GatekeeperWithAudioMP = 140,
      e_GatekeeperWithAVMP = 150,
      e_MCUOnly = 160,
      e_MCUWithDataMP = 170,
      e_MCUWithAudioMP = 180,
      e_MCUWithAVMP = 190
    };

    TerminalTypes GetTerminalType() const { return terminalType; }

    BOOL IsTerminal() const;

    BOOL IsGateway() const;

    BOOL IsGatekeeper() const;

    BOOL IsMCU() const;

    unsigned GetMinAudioJitterDelay() const { return manager.GetMinAudioJitterDelay(); }

    unsigned GetMaxAudioJitterDelay() const { return manager.GetMaxAudioJitterDelay(); }

    void SetAudioJitterDelay(
      unsigned minDelay,   
      unsigned maxDelay    
    ) { manager.SetAudioJitterDelay(minDelay, maxDelay); }

    unsigned GetInitialBandwidth() const { return initialBandwidth; }

    void SetInitialBandwidth(unsigned bandwidth) { initialBandwidth = bandwidth; }

    virtual BOOL OnSendFeatureSet(unsigned, H225_FeatureSet &);

    virtual void OnReceiveFeatureSet(unsigned, const H225_FeatureSet &);
        
#ifdef H323_H460

    H460_FeatureSet & GetFeatureSet() { return features; };
#endif

    virtual BOOL IsLocalAddress(
      const PIPSocket::Address & remoteAddress
    ) const { return manager.IsLocalAddress(remoteAddress); }

    virtual void TranslateTCPAddress(
      PIPSocket::Address & localAddr,
      const PIPSocket::Address & remoteAddr
    );

    WORD GetTCPPortBase() const { return manager.GetTCPPortBase(); }

    WORD GetTCPPortMax() const { return manager.GetTCPPortMax(); }

    void SetTCPPorts(unsigned tcpBase, unsigned tcpMax) { manager.SetTCPPorts(tcpBase, tcpMax); }

    WORD GetNextTCPPort() { return manager.GetNextTCPPort(); }

    WORD GetUDPPortBase() const { return manager.GetUDPPortBase(); }

    WORD GetUDPPortMax() const { return manager.GetUDPPortMax(); }

    void SetUDPPorts(unsigned udpBase, unsigned udpMax) { manager.SetUDPPorts(udpBase, udpMax); }

    WORD GetNextUDPPort() { return manager.GetNextUDPPort(); }

    WORD GetRtpIpPortBase() const { return manager.GetRtpIpPortBase(); }

    WORD GetRtpIpPortMax() const { return manager.GetRtpIpPortMax(); }

    void SetRtpIpPorts(unsigned udpBase, unsigned udpMax) { manager.SetRtpIpPorts(udpBase, udpMax); }

    WORD GetRtpIpPortPair() { return manager.GetRtpIpPortPair(); }

    BYTE GetRtpIpTypeofService() const { return manager.GetRtpIpTypeofService(); }

    void SetRtpIpTypeofService(unsigned tos) { manager.SetRtpIpTypeofService(tos); }

    const PTimeInterval & GetSignallingChannelCallTimeout() const { return signallingChannelCallTimeout; }

    const PTimeInterval & GetControlChannelStartTimeout() const { return controlChannelStartTimeout; }

    const PTimeInterval & GetEndSessionTimeout() const { return endSessionTimeout; }

    const PTimeInterval & GetMasterSlaveDeterminationTimeout() const { return masterSlaveDeterminationTimeout; }

    unsigned GetMasterSlaveDeterminationRetries() const { return masterSlaveDeterminationRetries; }

    const PTimeInterval & GetCapabilityExchangeTimeout() const { return capabilityExchangeTimeout; }

    const PTimeInterval & GetLogicalChannelTimeout() const { return logicalChannelTimeout; }

    const PTimeInterval & GetRequestModeTimeout() const { return logicalChannelTimeout; }

    const PTimeInterval & GetRoundTripDelayTimeout() const { return roundTripDelayTimeout; }

    const PTimeInterval & GetRoundTripDelayRate() const { return roundTripDelayRate; }

    BOOL ShouldClearCallOnRoundTripFail() const { return clearCallOnRoundTripFail; }

    const PTimeInterval & GetNoMediaTimeout() const { return manager.GetNoMediaTimeout(); }

    BOOL SetNoMediaTimeout(
      const PTimeInterval & newInterval  
    ) { return manager.SetNoMediaTimeout(newInterval); }

    const PTimeInterval & GetGatekeeperRequestTimeout() const { return gatekeeperRequestTimeout; }

    unsigned GetGatekeeperRequestRetries() const { return gatekeeperRequestRetries; }

    const PTimeInterval & GetRasRequestTimeout() const { return rasRequestTimeout; }

    unsigned GetRasRequestRetries() const { return rasRequestRetries; }

    const PTimeInterval & GetGatekeeperTimeToLive() const { return registrationTimeToLive; }

    void SetGatekeeperTimeToLive(const PTimeInterval & ttl) { registrationTimeToLive = ttl; }

    const PString & GetGkAccessTokenOID() const { return gkAccessTokenOID; }

    void SetGkAccessTokenOID(const PString & token) { gkAccessTokenOID = token; }

    BOOL GetSendGRQ() const
    { return sendGRQ; }

    void SetSendGRQ(BOOL v) 
    { sendGRQ = v; }

    const PTimeInterval & GetCallTransferT1() const { return callTransferT1; }

    const PTimeInterval & GetCallTransferT2() const { return callTransferT2; }

    const PTimeInterval & GetCallTransferT3() const { return callTransferT3; }

    const PTimeInterval & GetCallTransferT4() const { return callTransferT4; }

    const PTimeInterval & GetCallIntrusionT1() const { return callIntrusionT1; }
    const PTimeInterval & GetCallIntrusionT2() const { return callIntrusionT2; }
    const PTimeInterval & GetCallIntrusionT3() const { return callIntrusionT3; }
    const PTimeInterval & GetCallIntrusionT4() const { return callIntrusionT4; }
    const PTimeInterval & GetCallIntrusionT5() const { return callIntrusionT5; }
    const PTimeInterval & GetCallIntrusionT6() const { return callIntrusionT6; }

    H323CallIdentityDict& GetCallIdentityDictionary() { return secondaryConnectionsActive; }

#if OPAL_H450
    unsigned GetNextH450CallIdentityValue() const { return ++nextH450CallIdentity; }
#endif


  protected:
    H323Gatekeeper * InternalCreateGatekeeper(H323Transport * transport);
    BOOL InternalRegisterGatekeeper(H323Gatekeeper * gk, BOOL discovered);
    BOOL InternalMakeCall(
      OpalCall & call,
      const PString & existingToken,           
      const PString & callIdentity,            
      unsigned capabilityLevel,                
      const PString & remoteParty,             
      void * userData,                         
      unsigned int options = 0,                
      OpalConnection::StringOptions * stringOptions = NULL 
    );

    // Configuration variables, commonly changed
    PStringList localAliasNames;
    BOOL        autoStartReceiveFax;
    BOOL        autoStartTransmitFax;
    BOOL        isH224Enabled;
    BOOL        autoCallForward;
    BOOL        disableFastStart;
    BOOL        disableH245Tunneling;
    BOOL        disableH245inSetup;
    BOOL        m_bH245Disabled; /* enabled or disabled h245 */
    BOOL        canDisplayAmountString;
    BOOL        canEnforceDurationLimit;
#if OPAL_H450
    unsigned    callIntrusionProtectionLevel;
#endif

    TerminalTypes terminalType;

    BOOL          clearCallOnRoundTripFail;

    // Some more configuration variables, rarely changed.
    PTimeInterval signallingChannelCallTimeout;
    PTimeInterval controlChannelStartTimeout;
    PTimeInterval endSessionTimeout;
    PTimeInterval masterSlaveDeterminationTimeout;
    unsigned      masterSlaveDeterminationRetries;
    PTimeInterval capabilityExchangeTimeout;
    PTimeInterval logicalChannelTimeout;
    PTimeInterval requestModeTimeout;
    PTimeInterval roundTripDelayTimeout;
    PTimeInterval roundTripDelayRate;
    PTimeInterval gatekeeperRequestTimeout;
    unsigned      gatekeeperRequestRetries;
    PTimeInterval rasRequestTimeout;
    unsigned      rasRequestRetries;
    PTimeInterval registrationTimeToLive;

    PString       gkAccessTokenOID;
    BOOL          sendGRQ;

    /* Protect against absence of a response to the ctIdentify reqest
       (Transferring Endpoint - Call Transfer with a secondary Call) */
    PTimeInterval callTransferT1;
    /* Protect against failure of completion of the call transfer operation
       involving a secondary Call (Transferred-to Endpoint) */
    PTimeInterval callTransferT2;
    /* Protect against failure of the Transferred Endpoint not responding
       within sufficient time to the ctInitiate APDU (Transferring Endpoint) */
    PTimeInterval callTransferT3;
    /* May optionally operate - protects against absence of a response to the
       ctSetup request (Transferred Endpoint) */
    PTimeInterval callTransferT4;

    PTimeInterval callIntrusionT1;
    PTimeInterval callIntrusionT2;
    PTimeInterval callIntrusionT3;
    PTimeInterval callIntrusionT4;
    PTimeInterval callIntrusionT5;
    PTimeInterval callIntrusionT6;

    // Dynamic variables
    mutable H323Capabilities capabilities;
    H323Gatekeeper *     gatekeeper;
    PString              gatekeeperUsername;
    PString              gatekeeperPassword;
    H323CallIdentityDict secondaryConnectionsActive;

#if OPAL_H450
    mutable PAtomicInteger nextH450CallIdentity;
#endif

#if OPAL_H460
    H460_FeatureSet features;
#endif

};


#if P_SSL

class H323SecureEndPoint : public H323EndPoint
{
  PCLASSINFO(H323SecureEndPoint, H323EndPoint);
  public:
    enum {
      DefaultTcpSignalPort = 1300
    };

    H323SecureEndPoint(OpalManager & _manager)
      : H323EndPoint(_manager, "h323s", DefaultTcpSignalPort)
    {
    }

    PString GetDefaultTransport() const
    {  return "tcps$"; }
};

#endif // P_SSL

#endif // __OPAL_H323EP_H

---