(Objective-C) Create DSN (Delivery Status Notification) Email

See more Email Object Examples

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoEmail.h>
#import <CkoXml.h>
#import <CkoDateTime.h>
#import <CkoStringBuilder.h>
#import <NSString.h>

CkoEmail *email = [[CkoEmail alloc] init];

email.Subject = @"Test";
email.From = @"joe@example.com";
email.Body = @"This is a test";
[email AddTo: @"" emailAddress: @"recipient@example.com"];

NSLog(@"%@",[email GetMime]);
NSLog(@"%@",@"");
NSLog(@"%@",@"-------------------------------------------------------------");
NSLog(@"%@",@"");

// This is the email we just created:

// MIME-Version: 1.0
// Date: Mon, 12 May 2025 11:13:15 -0500
// Message-ID: <917FA49F75544EF51948B0A52F403B925B51073F@SLICE>
// Content-Type: text/plain; charset=us-ascii; format=flowed
// Content-Transfer-Encoding: 7bit
// X-Priority: 3 (Normal)
// Subject: Test
// From: joe@example.com
// To: recipient@example.com
// 
// This is a test

// -----------------------------------------------------------------
// Convert the above email into a DSN (Delivery Status Notification)

CkoXml *xml = [[CkoXml alloc] init];
xml.Tag = @"DeliveryStatusFields";
[xml NewChild2: @"Final-Recipient" content: @"rfc822; recipient@example.com"];
[xml NewChild2: @"Action" content: @"failed"];
[xml NewChild2: @"Status" content: @"5.1.2"];
[xml NewChild2: @"Diagnostic-Code" content: @"smtp; 550 5.1.2 Host unknown (Domain name not found)"];
CkoDateTime *dtNow = [[CkoDateTime alloc] init];
[dtNow SetFromCurrentSystemTime];
[xml NewChild2: @"Last-Attempt-Date" content: [dtNow GetAsRfc822: YES]];

BOOL headerOnly = YES;
CkoStringBuilder *sbText = [[CkoStringBuilder alloc] init];
[sbText Append: @"This is an automatically generated Delivery Status Notification.\r\n\r\n"];
[sbText Append: @"Delivery to the following recipient failed permanently:\r\n\r\n"];
[sbText Append: @"    recipient@example.com\r\n\r\n"];
[sbText Append: @"Technical details of permanent failure:\r\n"];
[sbText Append: @"DNS Error: Domain name not found\r\n"];

NSString *explain = [sbText GetAsString];

CkoEmail *dsnEmail = [[CkoEmail alloc] init];
BOOL success = [email ToDsn: explain statusFields: [xml GetXml] headerOnly: headerOnly dsnEmail: dsnEmail];
if (success == NO) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

NSLog(@"%@",[dsnEmail GetMime]);

// Here's the MIME of the DNS email we just created:
// -------------------------------------------------

// Content-Type: multipart/report; report-type="delivery-status"; boundary="------------060100020300020303000802"
// 
// --------------060100020300020303000802
// Content-Type: text/plain; charset=windows-1252; format=flowed
// Content-Transfer-Encoding: 7bit
// 
// This is an automatically generated Delivery Status Notification.
// 
// Delivery to the following recipient failed permanently:
// 
//     recipient@example.com
// 
// Technical details of permanent failure:
// DNS Error: Domain name not found
// 
// --------------060100020300020303000802
// Content-Type: message/delivery-status
// 
// Final-Recipient: rfc822; recipient@example.com
// Action: failed
// Status: 5.1.2
// Diagnostic-Code: smtp; 550 5.1.2 Host unknown (Domain name not found)
// Last-Attempt-Date: Mon, 12 May 2025 11:30:39 -0500
// 
// --------------060100020300020303000802
// Content-Type: text/rfc822-headers; charset=windows-1252
// 
// MIME-Version: 1.0
// Date: Mon, 12 May 2025 11:30:39 -0500
// Message-ID: <B8E6875D582A78AE779FC0B46ACC8C858CEAF608@SLICE>
// Content-Type: text/plain; charset=us-ascii; format=flowed
// Content-Transfer-Encoding: 7bit
// X-Priority: 3 (Normal)
// Subject: Test
// From: joe@example.com
// To: recipient@example.com
// --------------060100020300020303000802--