SQL Server

Get a MIME Header Field Value

Demonstrates the Chilkat Mime.GetHeaderField method, which returns the value of the first header field whose name matches case-insensitively. The only argument is the field name; it returns null when no matching field exists.

Note: The file path is relative to the application's current working directory. Absolute paths may also be used. Supply the path to your own file.

Background: This is the everyday way to read a header value — the Subject, a Message-ID, a custom X- header. Because a missing field returns null, the returned value is assigned to a variable and checked rather than used directly, so an absent header is handled cleanly instead of surfacing as an error later. Only the first matching occurrence is returned; iterate by index to see duplicates.

Chilkat SQL Server Downloads

Download Chilkat for SQL Server

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
    DECLARE @iTmp0 int
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

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

    EXEC sp_OAMethod @mime, 'LoadMimeFile', @success OUT, 'qa_data/message.eml'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @mime, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @mime
        RETURN
      END

    --  Return the value of the first header field with a matching (case-insensitive) name.
    --  GetHeaderField returns null when no matching field exists, so assign it to a string variable
    --  and check for success.
    DECLARE @subject nvarchar(4000)
    EXEC sp_OAMethod @mime, 'GetHeaderField', @subject OUT, 'Subject'
    EXEC sp_OAGetProperty @mime, 'LastMethodSuccess', @iTmp0 OUT
    IF @iTmp0 = 0
      BEGIN
        EXEC sp_OAGetProperty @mime, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @mime
        RETURN
      END

    PRINT 'Subject: ' + @subject

    EXEC @hr = sp_OADestroy @mime


END
GO