/*

* Copyright (c) 2006 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:  XIMP Framework process starter.

*

*/

#ifndef XIMPPROCESSSTARTER_H

#define XIMPPROCESSSTARTER_H

#include <e32std.h>

class TXIMPProcessStartupParam;

/**

 *

 *

 *

 *

 * @lib ?library

 * @since S60 v4.0

 */

class XIMPProcessStarter

    {

public:     // New methods

    /**

     *

     *

     *

     *

     */

    IMPORT_C static void FullExePathForClienLocation(

                    const TDesC& aExeName,

                    TFileName& aFullExePath );

    /**

     *

     * Usage example:

     * TFixedArray< TXIMPProcessStartupParam, 2 > params;

     * params[ 0 ].Set( 1, 1001 );

     * params[ 2 ].Set( 2, _L("value") );

     * TArray< TXIMPProcessStartupParam> paramsArray = params.Array();

     * TInt err = XIMPProcessStarter::StartInstance( KMySrvServerExe,

     *                                          _L("command line"),

     *                                           &paramsArray );

     */

    IMPORT_C static TInt StartInstance(

                    const TDesC& aFullExePath,

                    const TDesC& aCommand,

                    const TArray< TXIMPProcessStartupParam >* aParams );

    /**

     *

     *

     *

     *

     */

    IMPORT_C static TInt ConnectToServer(

                    const TDesC& aFullExePath,

                    const TDesC& aCommand,

                    const TArray< TXIMPProcessStartupParam >* aParams,

                    RSessionBase& aSessionToConnect,

                    const TDesC& aServerName,

                    const TVersion& aClientVersion,

                    TInt aAsyncMessageSlots );

private:    // Helpers

    static TInt DoStartInstance(

                    const TDesC& aFullExePath,

                    const TDesC& aCommand,

                    const TArray< TXIMPProcessStartupParam >* aParams );

        static TInt ApplyParameters(

                        const TArray< TXIMPProcessStartupParam >* aParams,

                        RProcess& aProcess );

    };

/**

 * Generic process startup parameters.

 *

 *

 *

 */

class TXIMPProcessStartupParam

    {

public:

    /**

     * C++ constructor

     */

    IMPORT_C TXIMPProcessStartupParam();

    /**

     *

     */

    void Set( TInt aSlot, const RHandleBase& aHandle );

    void Set( TInt aSlot, const RSubSessionBase& aSubSession );

    void Set( TInt aSlot, const TDesC16& aDes );

    void Set( TInt aSlot, const TDesC8& aDes );

    IMPORT_C void Set( TInt aSlot, TInt aInt );

    /**

     *

     *

     * @return

     */

    TInt ApplyParam( RProcess& aProcess ) const;

private: //data

    enum TParamType{ EUnknown, EHandle, ESubSession,

                     EDes16, EDes8, EInt };

    //OWN:

    TParamType iType;

    //OWN:

    TInt iSlot;

    //OWN:

    const RHandleBase* iHandle;

    const RSubSessionBase* iSubSession;

    TPtrC16 iDes16;

    TPtrC8 iDes8;

    TInt iInt;

    };

#endif      //  XIMPPROCESSSTARTER_H