btservices_plat/obex_service_plugin_api/inc/SrcsInterface.h
author hgs
Fri, 28 May 2010 17:03:06 +0300
changeset 32 19bd632b5100
permissions -rw-r--r--
201021
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
32
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2002-2007 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:  Define obexserviceman's service controller ECom interface.
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
hgs
parents:
diff changeset
    19
hgs
parents:
diff changeset
    20
#ifndef _SRCSINTERFACE_
hgs
parents:
diff changeset
    21
#define _SRCSINTERFACE_
hgs
parents:
diff changeset
    22
hgs
parents:
diff changeset
    23
hgs
parents:
diff changeset
    24
//INCLUDES
hgs
parents:
diff changeset
    25
#include <e32base.h>
hgs
parents:
diff changeset
    26
#include <ecom/ecom.h>
hgs
parents:
diff changeset
    27
#include <badesca.h>
hgs
parents:
diff changeset
    28
hgs
parents:
diff changeset
    29
// CONSTANTS
hgs
parents:
diff changeset
    30
const TUid KCSrcsInterfaceUid = {0x101F7C8C}; // UID of this interface
hgs
parents:
diff changeset
    31
hgs
parents:
diff changeset
    32
hgs
parents:
diff changeset
    33
enum TSrcsMediaType //transport media types
hgs
parents:
diff changeset
    34
    {
hgs
parents:
diff changeset
    35
        ESrcsMediaBT = 1,
hgs
parents:
diff changeset
    36
        ESrcsMediaIrDA,
hgs
parents:
diff changeset
    37
        ESrcsMediaUSB
hgs
parents:
diff changeset
    38
    };
hgs
parents:
diff changeset
    39
hgs
parents:
diff changeset
    40
/**
hgs
parents:
diff changeset
    41
*   An abstract class being representative of the
hgs
parents:
diff changeset
    42
*   concrete class which the client wishes to use.
hgs
parents:
diff changeset
    43
*
hgs
parents:
diff changeset
    44
*   It acts as a base, for a real class to provide all the
hgs
parents:
diff changeset
    45
*   functionality that a client requires.
hgs
parents:
diff changeset
    46
*   It supplies instantiation & destruction by using
hgs
parents:
diff changeset
    47
*   the ECom framework, and functional services
hgs
parents:
diff changeset
    48
*   by using the methods of the actual class.
hgs
parents:
diff changeset
    49
*/
hgs
parents:
diff changeset
    50
class CSrcsInterface : public CBase
hgs
parents:
diff changeset
    51
    {
hgs
parents:
diff changeset
    52
public:
hgs
parents:
diff changeset
    53
hgs
parents:
diff changeset
    54
    /**
hgs
parents:
diff changeset
    55
    * Two-phased constructor.
hgs
parents:
diff changeset
    56
    * @param aImplUid Implementation UId.
hgs
parents:
diff changeset
    57
    * @return newly created CSrcsInterface.
hgs
parents:
diff changeset
    58
    */
hgs
parents:
diff changeset
    59
    static CSrcsInterface* NewL(TUid aImplUid);
hgs
parents:
diff changeset
    60
hgs
parents:
diff changeset
    61
    /**
hgs
parents:
diff changeset
    62
    * Destructor
hgs
parents:
diff changeset
    63
    */
hgs
parents:
diff changeset
    64
    virtual ~CSrcsInterface();
hgs
parents:
diff changeset
    65
hgs
parents:
diff changeset
    66
    /** 
hgs
parents:
diff changeset
    67
	* Request a list of all available implementations which satisfies this given interface.
hgs
parents:
diff changeset
    68
    * @param aImplInfoArray Implementation instance array.
hgs
parents:
diff changeset
    69
    * @return none.
hgs
parents:
diff changeset
    70
	*/
hgs
parents:
diff changeset
    71
    static void ListAllImplementationsL(RImplInfoPtrArray& aImplInfoArray);
hgs
parents:
diff changeset
    72
hgs
parents:
diff changeset
    73
    /** 
hgs
parents:
diff changeset
    74
	* Request a list of matching implementations which satisfies this given interface.
hgs
parents:
diff changeset
    75
    * @param aMatchString	String to be matched by the implemention.
hgs
parents:
diff changeset
    76
    * @param aImplInfoArray Implementation instance array.
hgs
parents:
diff changeset
    77
    * @return none.
hgs
parents:
diff changeset
    78
	*/
hgs
parents:
diff changeset
    79
    static void ListImplementationsL(const TDesC8& aMatchString, RImplInfoPtrArray& aImplInfoArray);
hgs
parents:
diff changeset
    80
    
hgs
parents:
diff changeset
    81
hgs
parents:
diff changeset
    82
	/** 
hgs
parents:
diff changeset
    83
	* Check if OBEX service is still active.
hgs
parents:
diff changeset
    84
    * @return ETrue: OBEX service is still active.
hgs
parents:
diff changeset
    85
	*		  EFalse: OBEX service is inactive.
hgs
parents:
diff changeset
    86
	*/
hgs
parents:
diff changeset
    87
	virtual TBool IsOBEXActive() = 0;
hgs
parents:
diff changeset
    88
hgs
parents:
diff changeset
    89
	/** 
hgs
parents:
diff changeset
    90
	* Provide transport media information to service controller.
hgs
parents:
diff changeset
    91
	* @param aMediaType	enum value specifying transport media type.
hgs
parents:
diff changeset
    92
	* @return none.
hgs
parents:
diff changeset
    93
	*/
hgs
parents:
diff changeset
    94
	virtual void SetMediaType( TSrcsMediaType aMediaType ) ;
hgs
parents:
diff changeset
    95
hgs
parents:
diff changeset
    96
	/** 
hgs
parents:
diff changeset
    97
	* SetObexServer
hgs
parents:
diff changeset
    98
	* @param aObexServer pass obex server pointer to sevice controller
hgs
parents:
diff changeset
    99
	* @return none.
hgs
parents:
diff changeset
   100
	*/
hgs
parents:
diff changeset
   101
	virtual TInt SetObexServer( CObexServer* aObexServer );
hgs
parents:
diff changeset
   102
hgs
parents:
diff changeset
   103
protected:
hgs
parents:
diff changeset
   104
    /**
hgs
parents:
diff changeset
   105
    * C++ default Constructor
hgs
parents:
diff changeset
   106
    */
hgs
parents:
diff changeset
   107
    inline CSrcsInterface();
hgs
parents:
diff changeset
   108
hgs
parents:
diff changeset
   109
private:
hgs
parents:
diff changeset
   110
    // Unique instance identifier key
hgs
parents:
diff changeset
   111
    TUid iDtor_ID_Key;
hgs
parents:
diff changeset
   112
    };
hgs
parents:
diff changeset
   113
hgs
parents:
diff changeset
   114
#include "SrcsInterface.inl"
hgs
parents:
diff changeset
   115
hgs
parents:
diff changeset
   116
#endif
hgs
parents:
diff changeset
   117