SQL Server

Getting TO / CC Email Recipients

Demonstrates how to examine the TO and CC recipients of an email.

Note: BCC recipients are generally NOT found in the email's MIME. "BCC" is a "Blind Carbon Copy", which means that the TO and CC recipients of the email should not be able to see the BCC recipients. If the BCC email addresses were found in the MIME header, then they would no longer be "blind" because nothing would prevent the other recipients from seeing the list of BCC recipients.

To understand how BCC recipients receive an email, I recommend reading this blog post: SMTP Protocol in a Nutshell. The BCC recipients are passed to the SMTP server in “RCPT TO” commands.

SQL Server

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

    -- An email can have any number of To, CC, or Bcc recipients.
    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_OAMethod @email, 'LoadEml', @success OUT, 'sample.eml'
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @email, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @email
        RETURN
      END

    -- It doesn't matter if the email object was loaded from a .eml file,
    -- or if it was downloaded from a POP3 or IMAP server. 
    -- The methods and properties for examining the TO and CC
    -- recipients are the same.
    DECLARE @i int

    -- The number of TO recipients is found in the NumTo property
    DECLARE @numTo int
    EXEC sp_OAGetProperty @email, 'NumTo', @numTo OUT

    -- Iterate over each TO recipient
    IF @numTo > 0
      BEGIN
        SELECT @i = 0
        WHILE @i <= @numTo - 1
          BEGIN

            EXEC sp_OAMethod @email, 'GetTo', @sTmp0 OUT, @i
            PRINT 'TO Friendly Name and Address: ' + @sTmp0

            EXEC sp_OAMethod @email, 'GetToAddr', @sTmp0 OUT, @i
            PRINT 'TO Address: ' + @sTmp0

            EXEC sp_OAMethod @email, 'GetToName', @sTmp0 OUT, @i
            PRINT 'TO Friendly Name: ' + @sTmp0

            PRINT '---'
            SELECT @i = @i + 1
          END
      END

    -- The number of CC recipients is found in the NumCC property
    DECLARE @numCC int
    EXEC sp_OAGetProperty @email, 'NumCC', @numCC OUT

    -- Iterate over each CC recipient
    IF @numCC > 0
      BEGIN
        SELECT @i = 0
        WHILE @i <= @numCC - 1
          BEGIN

            EXEC sp_OAMethod @email, 'GetCC', @sTmp0 OUT, @i
            PRINT 'CC Friendly Name and Address: ' + @sTmp0

            EXEC sp_OAMethod @email, 'GetCcAddr', @sTmp0 OUT, @i
            PRINT 'CC Address: ' + @sTmp0

            EXEC sp_OAMethod @email, 'GetCcName', @sTmp0 OUT, @i
            PRINT 'CC Friendly Name: ' + @sTmp0

            PRINT '---'
            SELECT @i = @i + 1
          END
      END

    EXEC @hr = sp_OADestroy @email


END
GO