/*******************************************************************

Copyright (c) 2004 Open Mobile Alliance, Ltd.  All Rights Reserved.

This software is made available under the usage and distribution terms 
covered by the Common Public License 1.0 and by using this software you
are bound by the terms and conditions of the same.

EXCEPT AS EXPRESSLY SET FORTH IN THE COMMON PUBLIC LICENSE,
THIS PROGRAM IS PROVIDED ON AN "AS IS" BASIS, 
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 
EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, 
ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, 
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
   
Each recipient is solely responsible for determining the 
appropriateness of using and distributing this program and assumes 
all risks associated with its exercise of rights under the Common 
Public License, including but not limited to the risks and 
costs of program errors, compliance with applicable laws, 
damage to or loss of data, programs or equipment, and 
unavailability or interruption of operations.

********************************************************************/

#ifndef OBEXHANDLE_H
#define OBEXHANDLE_H
#include <constants.h>

#ifdef __cplusplus
extern "C" {
#endif

/*
**************************************************************************
**
** Obex Handle
**
** ObxHandles are general handle structures for obex.  They are returned to
** callers when they request a 'handle'.
**
**
**************************************************************************
*/
struct iobxHandle {
   ObxTransport   *transport;    /* Our transport mechanism                      */
   void           *connectionId; /* A connectionid associated with the transport */
   short          maxPacketLen;  /* Maximum size for any obex packets            */
   ObxCommand     lastSent;      /* Last cmd sent.                               */
   ObxCommand     lastRecv;      /* Last cmd received.                           */
};

/*
** Create a new handle.
*/
ObxHandle      *iobxHandleNew();

/*
** Cleanup and destroy a passed handle.
*/
void           iobxHandleFree( ObxHandle *handle );

/*
** Associate a transport with this handle.
*/
ObxRc          iobxHandleRegisterTransport( ObxHandle *handle, ObxTransport *transport );

#ifdef __cplusplus
}
#endif

#endif
