About the Mail Envelope API

About the Mail Envelope API

The Mail Envelope API allows a mail client to interface with applications in the 2007 Microsoft Office system and let their users send 2007 Office documents. If a default mail client implements this API, users will be able to use the Microsoft Office Outlook 2007 mail envelope experience directly in 2007 Office applications.

Note
The Mail Envelope API is being deprecated. Solution providers intending to develop mail clients to interface with versions of Office after the 2007 Microsoft Office system must not use this API.

The Mail Envelope API consists of the following interfaces and methods. For detailed descriptions of these interfaces and methods, see KB 926453: Description of the mail envelope API in 2007 Office applications.

Interface	Method	Description
IMsoEnvelope		Supports hosting a mail envelope in an application.
	Init	Initializes the envelope.
	SetParent	Gives the envelope the parent HWND.
	Resize	Tells the envelope to resize.
	Show	Tells the envelope to show itself or to hide itself.
	Save	Tells the envelope to save its data in a stream.
	GetAttach	This method is a no-op method and always returns S_OK.
	SetAttach	Adds an attachment to the envelope.
	NewAttach	This method is a no-op method and always returns S_OK.
	SetFocus	Tells the envelope to set focus in the envelope.
	GetHeaderInfo	Returns the information from the header.
	SetHeaderInfo	Sets information in the header.
	IsDirty	Indicates whether the envelope data is dirty.
	GetLastError	Returns the error string for the given error code.
	DoDebug	This method is a no-op method and always returns S_OK.
IMsoEnvelopeSite		Allows an envelope to interact with a hosting application.
	RequestResize	Requests that the host resizes the height of the envelope.
	CloseNote	Tells the host to close the message after it sends.
	GetBody	Obtains the body of the message.
	OnEnvSetFocus	Tells the host that focus has been put into the envelope.
	DirtyToolbars	Tells the host to consider the toolbars as dirty.
	OnPropChange	Tells the host that a header property has changed.
	GetFrameWnd	Asks for the HWND of the outermost frame window.
	TranslateAccelerators	Lets a host handle translating accelerators.
IMsoComponent		Allows an envelope interact with a hosting application.
	RequestResize	Requests that the host resizes the height of the envelope.
	FDebugMessage	This method is a no-op method and always returns S_OK.
	FPreTanslateMessage	Lets a component handle a message.
	OnEnterState	This method is a no-op method and always returns S_OK.
	OnAppActivate	This method is a no-op method and always returns S_OK.
	OnLoseActivation	This method is a no-op method and always returns S_OK.
	OnActivationChange	This method is a no-op method and always returns S_OK.
	FDoIdle	This method is a no-op method and always returns S_OK.
	FContinueMessageLoop	This method is a no-op method and always returns S_OK.
	FQueryTerminate	This method is a no-op method and always returns S_OK.
	Terminate	Tells the component that the component manager wants to terminate.
	HwndGetWindow	Retrieves the HWND for a particular window.
IMsoComponentManager		Allows an envelope to interact with a hosting application.
	FRegisterComponent	Registers a component with the component manager.
	FRevokeComponent	Revokes the registration of a component.
	FOnComponentActivate	Notifies the component manager that the component was activated.
IMsoEnvelopeHost		Supports creating an envelope note.
	CreateNote	Creates an enveloped note.