MNifAgentNotify Class Reference

class MNifAgentNotify

Interface from the agent to Nifman

since v9.5. Use MCPRs/CPRs/SCPRs instead of agents.

Member Functions Documentation

AgentEvent(TNetworkAdaptorEventType, TUint, const TDesC8 &, TAny *)

voidAgentEvent(TNetworkAdaptorEventTypeaEventType,
TUintaEvent,
const TDesC8 &aEventData,
TAny *aSource = 0
)[pure virtual]

Indication that some parameter relating to a subconnection has changed in the agent eg. new subconnection opened, QoS changed v7.0s

Parameters

TNetworkAdaptorEventType aEventTypeThe type of the event
TUint aEventThe event which has occured
const TDesC8 & aEventDataAny arguments or additional data to do with the event; the interpretation of this depends on the event
TAny * aSource = 0An appropriate identifier of the source of the event - this will be used when one receiver is receiving events from many producers

AgentProgress(TInt, TInt)

voidAgentProgress(TIntaStage,
TIntaError
)[pure virtual]

Progress notification from an agent for a connection v5.0

Parameters

TInt aStageThe progress stage that has been reached
TInt aErrorAny errors that have occured

AgentProgress(TSubConnectionUniqueId, TInt, TInt)

voidAgentProgress(TSubConnectionUniqueIdaSubConnectionUniqueId,
TIntaStage,
TIntaError
)[pure virtual]
Progress notification from an agent for a subconnection
Note:

This function will not be called until agents support starting subconnections

v7.0s

Parameters

TSubConnectionUniqueId aSubConnectionUniqueIdThe subconnection to which this notification refers
TInt aStageThe progress stage that has been reached
TInt aErrorAny errors that have occured

AuthenticateComplete(TInt)

voidAuthenticateComplete(TIntaStatus)[pure virtual]

Indication that the agent has finished authenticating

Parameters

TInt aStatusThe error code, if any, from the reconnection attempt

ConnectComplete(TInt)

voidConnectComplete(TIntaStatus)[pure virtual]

Callback to indicate that the agent has finished its connection phase, and is ready to pass control to the nif

Parameters

TInt aStatusThe error code generated by this phase of connection startup

DisconnectComplete()

voidDisconnectComplete()[pure virtual]

IncomingConnectionReceived()

TInt IncomingConnectionReceived()[pure virtual]
Note:

Needs to be called by the agent when it gets an incoming call so that agent can wait for an incoming and do an outgoing at the same time, i.e. it waits for the incoming without NifMan's knowledge

v6.1

Notification(TAgentToNifEventType, TAny *)

TInt Notification(TAgentToNifEventTypeaEvent,
TAny *aInfo = NULL
)[pure virtual]

Notification of an event from the nif KErrNone if successful, otherwise one of the system-wide error codes

Note:

SC with previous releases broken in v6.1 when first argument changed type

Parameters

TAgentToNifEventType aEventThe type of event that occured
TAny * aInfo = NULLAny data associated with the event

ReconnectComplete(TInt)

voidReconnectComplete(TIntaStatus)[pure virtual]
Callback to indicate that the agent has performed the requested reconnection
Note:

Obviously, this is only used in situations where the agent has received a request to reconnect

Parameters

TInt aStatusThe error code, if any, from the reconnection attempt

ServiceClosed()

voidServiceClosed()[pure virtual]

ServiceStarted()

voidServiceStarted()[pure virtual]
Callback from the agent to indicate that it has successfully started the connection
Note:

This call will cause nifman to load and bind the nif

This does not mean that the connection is ready for use by the nif yet - the nif is handed control after ConnectComplete()