TPop3Cli.Dele

From Overbyte
Revision as of 16:52, 4 July 2010 by Phz (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Main page -> ICS component reference -> TPop3Cli -> Dele

Definition

<syntaxhighlight lang="delphi"> procedure Dele; virtual; </syntaxhighlight>

Description

Sends DELE command to a POP3 server. This command is valid only during TRANSACTION state. It marks message as deleted and when the server enters UPDATE state it will delete the message. See Quit and Rset for more info.

To specify which message you want to mark as deleted set MsgNum to a specific value prior to calling Dele().

If Dele() is sent and you want to recover the message back (unmark it or undelete it) but you haven't entered the UPDATE state (in other words you haven't sent Quit() after sending Dele()) you may use Rset to clear all messages marked for deletion.

Delphi Example

<syntaxhighlight lang="delphi"> // Marks message 1 as "deleted" (will actually be deleted after Pop3Cli.Quit) Pop3Cli.MsgNum := 1; Pop3Cli.Dele; </syntaxhighlight>

See List or Uidl for more comprehensive example. Also you can look for OverbyteIcsMailRcv1 demo included in ICS distribution package.

C++ Example

<syntaxhighlight lang="cpp"> // Marks message 1 as "deleted" (will actually be deleted after Pop3Cli->Quit()) Pop3Cli->MsgNum = 1; Pop3Cli->Dele(); </syntaxhighlight>

See List or Uidl for more comprehensive example. Also you can look for OverbyteIcsMailRcv1 demo included in ICS distribution package.