Share via


FaxIncomingMessageIterator object

The FaxIncomingMessageIterator messaging object is used by a fax client application to move through the archive of inbound fax messages that the fax service has successfully received. Because the FaxIncomingMessageIterator object is a forward iterator, you can only move forward through the archive from beginning to end, and you can access only one fax message (FaxIncomingMessage object) at a time.

A FaxIncomingMessageIterator object is accessed through a FaxIncomingArchive object.

faxincomingarchive, faxincomingmessageiterator, and faxincomingmessage objects

Members

The FaxIncomingMessageIterator object has these types of members:

Methods

The FaxIncomingMessageIterator object has these methods.

Method Description
MoveFirst The MoveFirst method moves the archive cursor to the first fax message in the archive of inbound faxes.
MoveNext The MoveNext method moves the archive cursor to the next message in the archive of inbound faxes.

 

Properties

The FaxIncomingMessageIterator object has these properties.

Property Access type Description
AtEOF
Read-only
The AtEOF property is the end of file marker for the archive of inbound fax messages. If this property is equal to True, the archive cursor has moved beyond the last fax message in the inbound fax archive. If this property is equal to False, the archive cursor has not yet reached the end of the archive.
Message
Read-only
The Message property retrieves the inbound fax message under the archive cursor.
PrefetchSize
Read/write
The PrefetchSize property indicates the size of the prefetch (read-ahead) buffer.

 

Remarks

To create a FaxIncomingMessageIterator object in Microsoft Visual Basic, call the GetMessages method of the FaxIncomingArchive object.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Faxcomex.h
DLL
Fxscomex.dll
IID
CLSID_FaxIncomingMessageIterator

See also

Fax Service Extended COM Object Model

FaxIncomingArchive

IFaxIncomingMessageIterator