Share via

ExchangeClientRequestStatus (Windows Embedded CE 6.0)

  • Article

1/6/2010

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.

Syntax

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

Header iexchangeclient.h, iexchangeclient.idl
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

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