diff -r 000000000000 -r 89d6a7a84779 Symbian3/SDK/Source/GUID-E34D0F11-4B34-575C-BE78-8EAD13E9CD64.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-E34D0F11-4B34-575C-BE78-8EAD13E9CD64.dita Thu Jan 21 18:18:20 2010 +0000 @@ -0,0 +1,69 @@ + + + + + + Starting +and Closing a Management Plane session: Tutorial + + +

This tutorial shows how an application connects to +the Sockets Server to access the Management Plane functionality. The Management +Plane functionality allows an application to access the Access Points. The +Management Plane uses a different API to other Sockets Server connections. +

The RConnectionServ API is accessed through the Sockets Server client +API, so you need to ensure that esock.lib is included +in the MMP file.

The user must supply a valid Tier ID when the connection +is made. Tier's are discussed in the topic Tiers +Manager. Use the Tier +Table in the Communications Database to find the Tier IDs.

The +high level steps to connect to the Management Plane are:

+ +Determine which +Tier ID to supply + + +Call the RConnectionServ::Connect(TUint + aTierId) function with the Tier ID. This will connect +to the Management Plane. +By default, aTierId is Null to indicate all Tiers are +available. The aTierId must specify a valid tier. The RConnectionServ API +does not have any functionality if the default value for aTierId is +used. + + +Perform operations on the Tier. All actions on this RConnectionServ connection +will depend on the specified Tier. + + +Call the RConnectionServ::Close() function +to end the connection with the Management Plane. +The Close() function ends the RConnectionServ session +with the Tier specified using the Connect() function. + + +Connect and +Close example

The following example shows how to start and close +a session.

+#include <comms-infras/es_connectionserv.h> +#include <sometechnology.h> // for KSomeTierId + +using namespace ConnectionServ; + +// Assumption: RConnectionServ is owned as an attribute of some working object +protected: + RConnectionServ iConnServ; + +// Start the session +User::LeaveIfError(iConnServ.Connect(KSomeTierId)); + +// Close the session +iConnServ.Close(); +
+
\ No newline at end of file