ExchangeClientRequestStatus (Windows CE 5.0)

Send Feedback

This enumeration represents the different states in which a request can exist.

The IExchangeClientRequest::GetStatus and IExchangeClientRequestCallback::OnRequestProgress methods use entries from this enumeration to communicate status.

enum ExchangeClientRequestStatus{  e_ecrsPending = 0,  e_ecrsInProgress,  e_ecrsSending,  e_ecrsBypassingOWAPage,  e_ecrsSucceeded,  e_ecrsOutOfMemory,  e_ecrsParseFailed,  e_ecrsHttpFailure,  e_ecrsFailedToSend,  e_ecrsFailedToBypassAuthPage,   e_ecrsCancelled,  e_ecrsNoCredentials,};

Elements

• e_ecrsPending
  Request in request queue but not yet running.

• e_ecrsInProgress
  Request being processed.

• e_ecrsSending
  Request being processed.

  The Exchange client library is sending an HTTP request with the submitted information.

• e_ecrsBypassingOWAPage
  Request being processed.

  The Exchange client library is posting submitted user ID, password, and domain information to the login page.

• e_ecrsSucceeded
  Sending, receiving, and parsing completed successfully.

  Request has finished processing.

• e_ecrsOutOfMemory
  Request did not succeed because a memory allocation failed.

• e_ecrsParseFailed
  Sending and receiving completed without error but the request failed because the response could not be parsed.

• e_ecrsHttpFailure
  Sending completed without error but the request failed because the server responded with an HTTP failure code (like an HTTP 401 response code) instead of a response that could be parsed.

• e_ecrsFailedToSend
  Request failed because the request could not be sent.

  Proxy and server settings might not be valid.

• e_ecrsFailedToBypassAuthPage
  Request failed because the login page could not be passed.

  Credentials submitted to the login page might have been invalid.

• e_ecrsCancelled
  Request began processing but was cancelled before it completed.

  You can cancel requests using IExchangeClientRequest::Cancel or IExchangeClient::CancelPendingRequests methods.

  If the currently stored credentials change before a request finishes processing, the request is cancelled. Credentials must remain the same for the lifetime of each request.

• e_ecrsNoCredentials
  Request could not be processed because there are no available credentials.

  Use IExchangeClient::SetCredentials to provide this information.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: IExchangeClient.h, IExchangeClient.idl.

See Also

Exchange Client Enumerations | IExchangeClient::CancelPendingRequests | IExchangeClient::SetCredentials | IExchangeClientRequest::Cancel | IExchangeClientRequest::GetStatus | IExchangeClientRequestCallback::OnRequestProgress

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.