4D Internet Commands v16

SMTP_MessageID

Home

 
4D Internet Commands v16
SMTP_MessageID

SMTP_MessageID 


 

SMTP_MessageID ( smtp_ID ; message_ID {; option} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
smtp_ID  Lange Ganzzahl in Message reference
message_ID  Text in Unique ID of message
option  Ganzzahl in 0 = Add (default), 1 = Replace, 2 = Delete
Funktionsergebnis  Ganzzahl in Error code

The SMTP_MessageID command add a "message-id" field in the header of the message whose reference is passed in smtp_ID. This unique ID is used in particular on forums or public mailing lists. In general, mail servers automatically add this header to the messages they send. You can use this command to define its contents. 

smtp_ID contains the ID of an e-mail created with the SMTP_New command.

In message_ID, you pass an ID to associate with the message. The contents you pass is normally unrestricted, however conventionally, it is usually in the form "lettersOrNumbers@domainname", for example "abcdef.123456@4d.com". Note that certain e-mail servers (such as Gmail) do not recognize custom "message-id" headers and replace them when they are not in this form. 

The option parameter lets you specify whether any existing message_ID header should be kept or removed:

  • If you pass 0 (default value if parameter is omitted), the contents of the parameter passed are added to the existing contents.
  • If you pass 1, the contents of the parameter passed replace the existing contents.
  • If you pass 2, the existing contents are removed from the message.

In this example, a message with a specific "message-id" header is sent for each record of the [Admin] table:

 $error:=SMTP_New($smtp_id)
 $error:=SMTP_Host($smtp_id;"infoserv.com")
 $error:=SMTP_From($smtp_id;"info@infoserv.com")
 $error:=SMTP_Subject($smtp_id;"General statistics")
 FIRST RECORD([Admin])
 For($i;1;Records in selection([Admin]))
    $error:=SMTP_Body($smtp_id;$Stats)
    $error:=SMTP_To($smtp_id;[Admin]Email;1) // Replaces the "A" header with a new value
    $error:=SMTP_MessageID($smtp_id;[Admin]ID+"@infoserv.com";1) // Use of the admin ID
    $error:=SMTP_Send($smtp_id)
    NEXT RECORD([Admin])
 End for
 $error:=SMTP_Clear($smtp_id)

 
EIGENSCHAFTEN 

Produkt: 4D Internet Commands
Thema: IC Send Mail

 
GESCHICHTE 

Erstellt: 4D Internet Commands v14

 
ARTIKELVERWENDUNG

4D Internet Commands ( 4D Internet Commands v16)