Class TImSmtpProgress

class TImSmtpProgress;

Description

Progress information for SMTP operations on the Internet Mail MTM.

The information is obtained through calling CMsvOperation::Progress() on the operation. It is packaged into an 8-bit descriptor.

Messaging clients use the getter functions to get various types of information about an operation's progress. The setter functions are for use by the MTM.

Members

Defined in TImSmtpProgress:

• ConnectionIAP()constRetrieves the internet access point that is used when connecting to the SMTP ser...
• ConnectionState()constRetrieves the stage of the connection process as defined in nifvar.h and csdprog...
• DecrementSendTotal()Decrements the send total.
• Error()constGets an operation error code.
• FailedToSend()constGets the number of messages that the MTM failed to send this session.
• InitialiseTotal(const TInt &)Set the progress variables to initial values.
• MsgNo()constGets the index of the message that is currently being sent.
• NotSent()constGets the number of messages that the MTM did not attempt to send in this session...
• SendTotal()constGets the total number of messages that the MTM is attempting to send in this ses...
• Sent()constGets the number of messages sent so far in this SMTP session.
• ServiceId()constGets the message server entry ID of the SMTP service being used.
• SetConnectionIAP(TInt)Sets the ConnectionIAP value.
• SetError(TInt)Sets an error code for the operation.
• SetMsgNo(TInt)Sets the index of the message that is currently being sent.
• SetServiceId(TMsvId)Sets the message server entry ID of the SMTP service being used.
• SetStatus(TMsgImOutboxSendState)Sets the sending status of the SMTP operation
• Status()constGets the sending status of the SMTP operation.
• UpdateFailedToSend()Updates progress variables for when a message fails to be sent.
• UpdateSent()Updates progress variables for when a message is successfully sent.
• iSendFileProgressStatus information about the message that is currently being sent (if sending is...

IMPORT_C TMsgImOutboxSendState Status() const;

Description

Gets the sending status of the SMTP operation.

Return value

IMPORT_C TInt MsgNo() const;

Description

Gets the index of the message that is currently being sent.

The index range is from 0 to TImSmtpProgress::SendTotal()const.

Return value

IMPORT_C TInt Error() const;

Description

Gets an operation error code.

This is set only when a send operation has completed.

Return value

IMPORT_C TInt Sent() const;

Description

Gets the number of messages sent so far in this SMTP session.

Return value

IMPORT_C TInt NotSent() const;

Description

Gets the number of messages that the MTM did not attempt to send in this session.

A possible reason is because the message store was locked by another client.

Return value

IMPORT_C TInt FailedToSend() const;

Description

Gets the number of messages that the MTM failed to send this session.

For example, failure could be because the SMTP server refused to accept a message.

Return value

IMPORT_C TInt SendTotal() const;

Description

Gets the total number of messages that the MTM is attempting to send in this session.

The following equation is always true: TImSmtpProgress::Sent()const + TImSmtpProgress::NotSent()const + TImSmtpProgress::FailedToSend()const = TImSmtpProgress::SendTotal()const.

Return value

IMPORT_C void SetError(TInt anError);

Description

Sets an error code for the operation.

Parameters

IMPORT_C void SetStatus(TMsgImOutboxSendState aStatus);

Description

Sets the sending status of the SMTP operation

Parameters

IMPORT_C void SetMsgNo(TInt aMsgNo);

Description

Sets the index of the message that is currently being sent.

Parameters

IMPORT_C void InitialiseTotal(const TInt &aTotal);

Description

Set the progress variables to initial values.

The "send total" and "not sent" variables are set to aTotal. Other counter variables are set to 0. The initial status is set to EMsgOutboxProgressWaiting.

Parameters

IMPORT_C void UpdateSent();

Description

Updates progress variables for when a message is successfully sent.

The "message sent" count is incremented; the "not sent" count is decremented.

IMPORT_C void UpdateFailedToSend();

Description

Updates progress variables for when a message fails to be sent.

The "failed to send" count is incremented; the "not sent" count is decremented.

IMPORT_C void DecrementSendTotal();

Description

Decrements the send total.

This can be used to adjust the total if a message is found to be deleted before it can be sent.

IMPORT_C TMsvId ServiceId() const;

Description

Gets the message server entry ID of the SMTP service being used.

Return value

IMPORT_C void SetServiceId(TMsvId aServiceId);

Description

Sets the message server entry ID of the SMTP service being used.

Parameters

IMPORT_C TInt ConnectionState() const;

Description

Retrieves the stage of the connection process as defined in nifvar.h and csdprog.h while the service is connecting to the SMTP server.

Return value

IMPORT_C TInt ConnectionIAP() const;

Description

Retrieves the internet access point that is used when connecting to the SMTP service.

Return value

IMPORT_C void SetConnectionIAP(TInt aConnectionIAP);

Description

Sets the ConnectionIAP value.

Parameters

TImImailFileProgress iSendFileProgress;

Description

Status information about the message that is currently being sent (if sending is in progress).