SQL Server

Request a Return Receipt for an Email

Demonstrates the Chilkat Email.ReturnReceipt property. Set it to true to request a return-receipt when the message is received; this causes a Disposition-Notification-To header to be added when the email is sent. The default is false. This example enables the request.

Background: A return receipt (technically a Message Disposition Notification, MDN) asks the recipient's mail client to send back a small confirmation when the message is opened. It is only a request: the receiving client or server is free to ignore it, and many prompt the user before sending anything. Because of this, a return receipt is not reliable proof that a human actually read the message — treat it as a courtesy signal, not a guarantee.

Chilkat SQL Server Downloads

Download Chilkat for SQL Server

SQL Server

--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    --  Demonstrates the Email.ReturnReceipt property.  Set to true to request a
    --  return-receipt when the email is received.  This causes a Disposition-Notification-To
    --  header to be added when the email is sent.  The default is false.

    DECLARE @email int
    EXEC @hr = sp_OACreate 'Chilkat.Email', @email OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    EXEC sp_OASetProperty @email, 'Subject', 'Please confirm receipt'
    EXEC sp_OASetProperty @email, 'Body', 'Kindly confirm you received this message.'
    EXEC sp_OASetProperty @email, 'From', 'alice@example.com'
    DECLARE @success int
    EXEC sp_OAMethod @email, 'AddTo', @success OUT, 'Bob', 'bob@example.com'

    --  Request a return receipt.
    EXEC sp_OASetProperty @email, 'ReturnReceipt', 1


    EXEC sp_OAGetProperty @email, 'ReturnReceipt', @iTmp0 OUT
    PRINT 'ReturnReceipt = ' + @iTmp0

    EXEC @hr = sp_OADestroy @email


END
GO