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.