diff -r f1578314b8da -r 505ad3f0ce5c Msrp/MsrpClient/inc/MMSRPSessionObserver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Msrp/MsrpClient/inc/MMSRPSessionObserver.h Sat Jun 12 14:30:11 2010 +0530 @@ -0,0 +1,105 @@ +/* +* Copyright (c) 2009-2010 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html." +* Initial Contributors: +* Nokia Corporation - initial contribution. +* Contributors: +* +* Description: +* MSRP Implementation +* +*/ + +#ifndef MMSRPSESSIONOBSERVER_H_ +#define MMSRPSESSIONOBSERVER_H_ + +// INCLUDES +#include "MsrpCommon.h" + +// FORWARD DECLARATIONS +class CMSRPMessage; + + +class MMSRPSessionObserver + { + public: + + /** + * An MSRP SEND request has been received from the network. + * The content of the request is given to the client, along with the + * status of receiving the request. Ownership of the content is transferred. + * @param aMessageContent the received message content + * @param aStatus KErrNone with complete message, KErrCancel if terminated + */ + virtual void IncomingMessage( HBufC8* aMessageContent, TInt aStatus ) = 0; + + /** + * An MSRP REPORT request has been received from the network. + * This function is called to notify the client that a recipient wishes + * to indicate a range of bytes as received, or to indicate an error. + * However, it is the client's responsibility to handle this information. + * @param aStatus status code from the REPORT request + * @param aRangeStart start of the byte range being reported + * @param aRangeEnd end of the byte range being reported + * @param aTotal total number of bytes in the message + * NOTE: This callback not issued currently, REPORTs support not present + */ + virtual void IncomingReport( TInt aStatus, TInt aRangeStart, + TInt aRangeEnd, TInt aTotal ) = 0; + + /** + * Result of the send operation initiated by the client + * @param aStatus error code as defined in MsrpCommon::TErrorCode + * @param aMessageId message identifier of the sent message that + * was returned by the SendBuffer call + */ + virtual void SendResult( TInt aStatus, const TDesC8& aMessageid ) = 0; + + /** + * Indicates a failure in connection establishment + * or in case of any error in an established connection + * @param aStatus a system wide error code + */ + virtual void ListenPortFailure( TInt aStatus ) = 0; + + /** + * Result of the connection attempt made by the client. This callback is + * issued, both while initiating a connection with ConnectL and while + * receiving a connection with ListenL, once the call completes. + * Client must wait for this callback before trying to send out any + * messages to the remote user. + * @param aStatus KErrNone or a system wide error code + */ + virtual void ConnectStatus( TInt aStatus ) = 0; + + /** + * Notifies that the entire file has been sent successfully + */ + virtual void SendFileNotification(TBool aStatus) = 0; + + /** + * Notifies that the entire file has been received successfully + */ + virtual void ReceiveFileNotification(TBool status) = 0; + + /** + * File data transfer progress. returns the progress of data transfer + * @param aTransferred number of bytes transferred + * @param aTotal Total amount of bytes to be transferred + */ + virtual void FileSendProgress( TInt aTransferred, TInt aTotal ) = 0; + + /** + * File receive progress, number of bytes received from incoming data + * @param aReceived number of bytes received + * @param aTotal Total amount of bytes to be received + */ + virtual void FileReceiveProgress( TInt aReceived, TInt aTotal ) = 0; + + }; + +#endif /* MMSRPSESSIONOBSERVER_H_ */