--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/ximpfw/core/srcclient/ximpprocessstarter.h Thu Dec 17 08:54:49 2009 +0200
@@ -0,0 +1,151 @@
+/*
+* 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"),
+ * ¶msArray );
+ */
+ 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
+
+