Export (0) Print
Expand All

ExchangePollingMailboxProvider Class (E-mail Providers)

banner art

[Applies to: Microsoft Dynamics CRM 4.0]

Provides polling-based processing semantics applied to an Exchange sink mailbox.

The ExchangePollingMailboxProvider class inherits from CrmPollingMailboxProvider. It exposes the following members.

ExchangePollingMailboxProviderInitializes a new instance of the ExchangePollingMailboxProvider class.

Instance MethodDescription
AcceptMessageInternalChecks a message for delivery.
CloseMailboxCloses a mailbox.
DeliverMessageInternalDelivers a message.
HandleAcceptMessageErrorHandles errors when checking a message for delivery.
HandleDeliverMessageErrorHandles errors when delivering a message.
HandleRetrieveNextMessageErrorHandles errors when retrieving the next message.
HandleValidateMessageErrorHandles errors when validating a message.
OpenMailboxOpens a mailbox.
RetrieveNextMessageInternalRetrieves the next message.
ValidateMessageInternalValidates a message.

Instance PropertyDescription
BatchSizeGets the number of users and queues to batch together when making one BackgroundSendEmail request.
CacheCapacityGets the cache capacity (hash table) size.
DeleteEmailsGets a value indicating if the e-mail should be deleted from the mailbox after it is processed.
IdentityHashGets the hash which uniquely identifies a provider instance.
IsForwardMailboxGets a value that indicates if the mailbox being monitored is a forward mailbox.
MessageExpiryGets the threshold time after which a message in the mailbox is considered old and will no longer be processed.
MoveEmailsGets a value that indicates if the undeliverable e-mail should be moved to a separate folder.
ThresholdDateTimeGets or sets the threshold date and time after which a message in the mailbox is processed.


This class provides functionality equivalent to the Microsoft CRM 3.0 Exchange Connector implementation. In particular, the following behavior is implemented by the class.

  1. The mailbox is assumed to be a local Exchange server mailbox.
  2. Additional configuration properties are used (for example: IsForwardMailbox, MessageExpiry).
  3. CDO and ADODB interops are used to connect to the mailbox.
  4. Messages are typically received as forward-as-attachment messages.
  5. An in-memory cache is used to pre-filter duplicate forwarded e-mail copies.
  6. After processing, messages are deleted from the mailbox.
  7. In failure cases, messages are retried until they expire.
  8. Failing expired messages are moved to an undeliverable folder.
  9. An undeliverable folder is created if needed.
  10. Additional message checks occur (for example: check if the e-mail is forward-as-attachment).


Namespace: Microsoft.Crm.Tools.Email.Providers

Assembly: Microsoft.Crm.Tools.EmailProviders.dll

See Also


© 2010 Microsoft Corporation. All rights reserved.

© 2014 Microsoft