Sample code for 30+ languages & platforms
SQL Server

Process New Email by Scanning for Senders

Scan email and save application-selected emails to EML files with unique filenames.

Chilkat SQL Server Downloads

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

    -- This example assumes the Chilkat API to have been previously unlocked.
    -- See Global Unlock Sample for sample code.

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

    -- Connect to an IMAP server.
    -- Use TLS
    EXEC sp_OASetProperty @imap, 'Ssl', 1
    EXEC sp_OASetProperty @imap, 'Port', 993
    EXEC sp_OAMethod @imap, 'Connect', @success OUT, 'imap.example.com'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @imap, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @imap
        RETURN
      END

    -- Login
    EXEC sp_OAMethod @imap, 'Login', @success OUT, 'myLogin', 'myPassword'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @imap, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @imap
        RETURN
      END

    -- Select an IMAP mailbox
    EXEC sp_OAMethod @imap, 'SelectMailbox', @success OUT, 'Inbox'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @imap, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @imap
        RETURN
      END

    -- We can choose to fetch UIDs or sequence numbers.
    DECLARE @fetchUids int
    SELECT @fetchUids = 1

    -- Fetch messages from the mailbox using a search criteria.
    -- This example finds NEW emails: these are emails that have the RECENT flag set, but not the SEEN flag:
    DECLARE @messageSet int
    EXEC @hr = sp_OACreate 'Chilkat.MessageSet', @messageSet OUT

    EXEC sp_OAMethod @imap, 'QueryMbx', @success OUT, 'NEW', @fetchUids, @messageSet
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @imap, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @imap
        EXEC @hr = sp_OADestroy @messageSet
        RETURN
      END

    -- This example will download headers, and then download
    -- the full email for those emails sent from a contact
    -- in our database.

    -- When downloading headers, each email object contains
    -- (obviously) the headers, but the body will be missing.
    -- Also, attachments will not be included.  However, it is
    -- possible to get information about the attachments
    -- as well as the complete size of the email.
    DECLARE @bundle int
    EXEC @hr = sp_OACreate 'Chilkat.EmailBundle', @bundle OUT

    DECLARE @headersOnly int
    SELECT @headersOnly = 1
    EXEC sp_OAMethod @imap, 'FetchMsgSet', @success OUT, @headersOnly, @messageSet, @bundle
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @imap, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @imap
        EXEC @hr = sp_OADestroy @messageSet
        EXEC @hr = sp_OADestroy @bundle
        RETURN
      END

    -- Loop over the email objects...
    DECLARE @emailHeader int
    EXEC @hr = sp_OACreate 'Chilkat.Email', @emailHeader OUT

    DECLARE @fullEmail int
    EXEC @hr = sp_OACreate 'Chilkat.Email', @fullEmail OUT

    DECLARE @i int
    SELECT @i = 0
    DECLARE @numEmails int
    EXEC sp_OAGetProperty @bundle, 'MessageCount', @numEmails OUT
    WHILE @i < @numEmails
      BEGIN
        EXEC sp_OAMethod @bundle, 'EmailAt', @success OUT, @i, @emailHeader

        -- The sender's email address and name are available
        -- in the From, FromAddress, and FromName properties.
        -- If the sender is "Chilkat Support <support@chilkatsoft.com",
        -- then the From property will hold the entire string.
        -- the FromName property contains"Chilkat Support",
        -- and the FromAddress property contains "support@chilkatsoft.com"
        EXEC sp_OAGetProperty @emailHeader, 'From', @sTmp0 OUT
        PRINT @sTmp0
        EXEC sp_OAGetProperty @emailHeader, 'FromAddress', @sTmp0 OUT
        PRINT @sTmp0
        EXEC sp_OAGetProperty @emailHeader, 'FromName', @sTmp0 OUT
        PRINT @sTmp0

        -- Assume at this point your code checks to see if the sender
        -- is one in your contacts database.  If so, this is
        -- the code you would write to download the entire
        -- email and save it to a file.

        -- The ckx-imap-uid header field is added when
        -- headers are downloaded.  This makes it possible
        -- to get the UID from the email object.
        DECLARE @uidStr nvarchar(4000)
        EXEC sp_OAMethod @emailHeader, 'GetHeaderField', @uidStr OUT, 'ckx-imap-uid'
        DECLARE @uid int
        SELECT @uid = @

        EXEC sp_OAMethod @imap, 'FetchEmail', @success OUT, 0, @uid, 1, @fullEmail
        IF @success = 0
          BEGIN
            EXEC sp_OAGetProperty @imap, 'LastErrorText', @sTmp0 OUT
            PRINT @sTmp0
            EXEC @hr = sp_OADestroy @imap
            EXEC @hr = sp_OADestroy @messageSet
            EXEC @hr = sp_OADestroy @bundle
            EXEC @hr = sp_OADestroy @emailHeader
            EXEC @hr = sp_OADestroy @fullEmail
            RETURN
          END

        -- You can use the GenerateFilename method to
        -- generate a unique filename...
        DECLARE @filename nvarchar(4000)
        EXEC sp_OAMethod @fullEmail, 'GenerateFilename', @filename OUT

        -- SaveEml saves the entire email, including attachments.
        EXEC sp_OAMethod @fullEmail, 'SaveEml', @success OUT, @filename


        PRINT '--'

        SELECT @i = @i + 1
      END

    -- Disconnect from the IMAP server.
    EXEC sp_OAMethod @imap, 'Disconnect', @success OUT

    EXEC @hr = sp_OADestroy @imap
    EXEC @hr = sp_OADestroy @messageSet
    EXEC @hr = sp_OADestroy @bundle
    EXEC @hr = sp_OADestroy @emailHeader
    EXEC @hr = sp_OADestroy @fullEmail


END
GO