Constructor - set initial values and copy in protocol policy information

Destructor.

Put into transport connected state but cancel any outstanding transfers and operations

This function is in the protected scope of CObex and so is not externally usable

This function will tear down the transport if the transport layer supports transport reconnection on obex reconnection This is called in conditions other than error conditions

ForcedTransportDown()

This function is retained for backwards compatibility and should not be called.

Calling this function has undefined behaviour.

This function forces the transport to be taken down regardless of whether or not the underlying transport can recover without restarting obex applications However if the transport controller fails to bring the transport down, then only the obex connection is cancelled. This is called in error conditions

ControlledTransportDown()

Get the current state of the authentication state machine

Indicates if the Server / Client is currently authenticating the OBEX connection.

Returns ETrue if this CObex is connected at an OBEX level, merely having a transport connected does not satisfy this condition. I.e. the two devices must have completed the OBEX connection request/response . All other states return EFalse. This will be unreliable if either the server blindly returns the client s who header (always reporting ETrue), or if neither supply "who" headers (always reporting EFalse).

Use this member to gain access to (and alter, if necessary) the CObex::TConnectInfo structure which will be sent to the OBEX peer as part of the connection process. Only alter the contents of this having read and understood the purpose of the fields, as defined in the OBEX spec. Altering this structure after a connection has been made will have no effect on the current session, but will be used for future connection attempts.

This function is retained for backwards compatibility and should not be called.

Calling this function has undefined behaviour.

Get the socket address of the remote device.

This is the address of the device OBEX is connected to over an IrDA or Bluetooth socket.

Use this member to read the details of the remote machine s connection information, as specified by it in during OBEX connection. This data can not be altered, as this serves no purpose. The content of this structure is undefined when IsConnected () == EFalse .

General cleanup of iRemoteInfo

Sets the authentication challenge handler.

The caller must supply a MObexAuthChallengeHandler implementation to handle calls from the Server/Client for a request for a password.

Change the state of the authentication state machine

Sets the local Who field.

This is used to identify the local end of the OBEX session when the OBEX connection is made. If it is required, set it before establishing the connection.

This function is retained for backwards compatibility and should not be called. Use ControlledTransportDown() or ForcedTransportDown() to disconnect the transport layer. Calling this function will result in an ETransportDownCalled panic.

This function is retained for backwards compatibility and should not be called.

Calling this function has undefined behaviour.

Current obex connection state In general, the further through the enum the values are, the further through the connection process the state machine will be.

Flags to suppress the authentication elements of the authentication challenge header.

The Obex operation currently being performed.