IFaxIncomingMessage2 interface

Applies to: desktop apps only

Used by a fax client application to retrieve information about a received fax message in the archive of inbound faxes. The archive contains faxes received successfully by the fax service. The interface also includes methods to delete a message from the archive and to copy the Tagged Image File Format Class F (TIFF Class F) file associated with the fax message to a file on the local computer.

The IFaxIncomingMessage2 interface is accessed through the IFaxAccountIncomingArchive interface or IFaxIncomingMessageIterator interface.

Members

The IFaxIncomingMessage2 interface inherits from the IDispatch interface. IFaxIncomingMessage2 also has these types of members:

Methods

The IFaxIncomingMessage2 interface has these methods.

MethodDescription
Reassign

Reassign the fax to one or more recipients. It also commits changes to the IFaxIncomingMessage2::Subject, IFaxIncomingMessage2::SenderName, IFaxIncomingMessage2::SenderFaxNumber, and IFaxIncomingMessage2::HasCoverPage properties.

Note  This method is supported only in Windows Vista and later.

Refresh

Refreshes FaxIncomingMessage object information from the fax server. When the Refresh method is called, any configuration changes made after the last Save method call are lost, except for the properties that are committed with the IFaxIncomingMessage2::Reassign method: IFaxIncomingMessage2::Subject, IFaxIncomingMessage2::SenderName, IFaxIncomingMessage2::SenderFaxNumber, and IFaxIncomingMessage2::HasCoverPage.

Note  This method is supported only in Windows Vista and later.

Save

Saves the FaxIncomingMessage object's data.

Note  This method is supported only in Windows Vista and later.

 

Properties

The IFaxIncomingMessage2 interface has these properties.

PropertyAccess typeDescription

HasCoverPage

Read/write

A flag that indicates whether the fax has a cover page.

Note  This property is supported only in Windows Vista and later.

Read

Read/write

A flag that indicates if the fax has been read.

Note  This property is supported only in Windows Vista and later.

Recipients

Read/write

Contains the recipients associated with the inbound fax message. This property is a null-terminated string.

Note  This property is supported only in Windows Vista and later.

SenderFaxNumber

Read/write

Contains the sender's fax number associated with the inbound fax message. This property is a null-terminated string.

Note  This property is supported only in Windows Vista and later.

SenderName

Read/write

Contains the name of the sender that is associated with the inbound fax message. This property is a null-terminated string.

Note  This property is supported only in Windows Vista and later.

Subject

Read/write

The Subject property contains the subject associated with the inbound fax message. This property is a null-terminated string.

Note  This property is supported only in Windows Vista and later.

WasReAssigned

Read-only

Indicates if the fax has been reassigned.

Note  This property is supported only in Windows Vista and later.

 

Remarks

To create a FaxIncomingMessage2 object in C++, call the IFaxAccountIncomingArchive::GetMessage method or the IFaxIncomingMessageIterator::get_Message method.

A default implementation of this interface is provided by the FaxIncomingMessage object.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

FaxComex.h

DLL

Fxscomex.dll

See also

IFaxAccountIncomingArchive
IFaxIncomingMessageIterator
FaxIncomingMessage

 

 

Build date: 5/5/2012

Community Additions

ADD
Show: