Who Should Read This Guide

What's in This Guide

Organization

Quick Reference to Tasks

Conventions Used in This Guide

Where to Find More Information

Part 1 Using the Messaging Access SDK

The Netscape Messaging Access software development kit (SDK) provides a set of Protocol Level APIs that the developer can use to write messaging applications and extend applications with messaging services. This chapter is an overview of the Messaging Access SDK, version 3.5.

How the Protocol APIs Work Together

The Messaging Access SDK, C Version

Supported Platforms

SDK Response Sinks for C

SDK Error Codes for C

Compiling with the C SDK

Including C Header Files

Compiling on Unix

Compiling on MS Windows

This chapter is an overview of using SMTP (Simple Mail Transfer Protocol) to create and send email messages.

The SMTP Protocol

Steps in an SMTP Session

SMTP Response Codes

SMTP Function Callback Mapping

Creating a Response Sink

Creating a Client

Connecting to a Server

Determining ESMTP Support

Pipelining Commands

Setting the Mailer

Setting the Recipient

Sending the Message

Ending the Session

SMTP Functions by Task

This chapter is an overview of using the MIME (Multipurpose Internet Mail Extension) API of the Messaging Access SDK to encode, decode, and parse mail messages, and handle text and non-text attachments.

The MIME Protocol

MIME Encoding Types

MIME Content Types

Structure of a MIME Message

Steps in a MIME Session

Building the MIME Message

Adding Message Headers

Adding Content to the Message

Building a Multipart

Adding Parts to the Message

Adding a Message Part to a Message

Deleting Parts of a Message

Encoding the Message

Encoding and Decoding Utilities

Parsing MIME Messages

Parsing the Entire Message

Dynamic Parsing

MIME Functions by Task

This chapter is an overview of using IMAP4 (Internet Message Access Protocol 4) to retrieve and manage messages remotely.

The IMAP4 Protocol

IMAP4 Session States

Steps in an IMAP4 Session

IMAP4 Function Callback Mapping

Creating a Response Sink

Creating a Client

Connecting to a Server

Determining Server Capabilities

Logging In and Out

Checking for New Messages

Searching for Messages

Fetching Message Data

Closing a Mailbox

IMAP4 Functions by Task

This chapter is an overview of using POP3 (Post Office Protocol 3) to download messages to a client.

The POP3 Protocol

POP3 Session States

Steps in a POP3 Session

POP3 Response Codes

POP3 Function Callback Mapping

Creating a Response Sink

Creating a Client

Connecting to a Server

Logging In

Getting Message Count

Listing Messages

Retrieving Message Headers

Retrieving a Message

Ending the Session

POP3 Functions by Task

Part 2 Messaging Access SDK C Reference

This page contains links to the reference to the C versions of the Messaging Access SDK Protocol APIs.

This chapter summarizes essential information about the Internet Protocols accessed through the Messaging Access SDK.

Supported SMTP Internet Protocol Commands

Supported IMAP4 Internet Protocol Commands

Supported POP3 Internet Protocol Commands

This chapter describes the C language functions, structures, and definitions shared by all Messaging Access SDK APIs.

Shared Definitions

Constants

Option Definition

Error Definitions

Shared Structures

Shared Functions

This chapter describes the functions and structures of the C language API for the SMTP (Simple Mail Transfer Protocol) protocol of the Messaging Access SDK.

SMTP Functions

SMTP Structures

This chapter describes the functions and structures of the C language API for the MIME (Multipurpose Internet Mail Extension) protocol of the Messaging Access SDK.

MIME Functions by Functional Group

MIME Functions by Name

Basic (Leaf) Body Part Functions

Message Functions

Message Part Functions

Multipart Functions

MIME Utility Functions

Dynamic Parsing Functions

Message Parsing Functions

Data Sink Functions

MIME Structures

MIME Definitions

MIME Error Codes

MIME Type Definitions

MIME Buffer Size

This chapter describes the functions and structures of the C language API for the IMAP4 (Internet Message Access Protocol, Version 4) protocol of the Messaging Access SDK.

IMAP4 Functions by Functional Group

IMAP4 Functions by Name

General Functions

Non-Authenticated State Functions

Authenticated State Functions

Selected State Functions

Extended IMAP4 Functions

IMAP4 Structures

This chapter describes the functions and structures of the C language API for the POP3 (Post Office Protocol) protocol of the Messaging Access SDK.

POP3 Functions

POP3 Structures

This appendix provides some important information for developers who want to take advantage of multithreading in their messaging applications.

Multithreading in the MIME API

Last Updated: June 3, 1998