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.
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 |
|
| DLL |
|
| IID |
CLSID_FaxIncomingMessageIterator |
See also