IExchangeClient::RequestGALSearch (Windows CE 5.0)

Send Feedback

This method initiates a request to the Exchange server for information from the global address list (GAL).

HRESULT RequestGALSearch(  struct GALSearchCriteria* pCriteria,  IExchangeClientRequest** ppiRequest);

Parameters

  • pCriteria
    [in] Pointer to a GALSearchCriteria instance that constrains the search to specified GAL information.

    At least one field in the GALSearchCriteria instance must be specified.

  • ppiRequest
    [out, retval] Pointer to a caller-supplied variable that this method uses to return a reference to an IExchangeClientRequest instance that represents this request.

Return Values

The following table shows possible return values:

Value Description
E_POINTER The address of pCriteria does not point to a structure.
E_OUTOFMEMORY Not enough memory was available to initiate the request.
OWAEC_E_INVALIDSEARCH All fields in the structure pointed to by pCriteria are NULL or are empty. At least one piece of criteria information must be specified.
OWAEC_E_NOTINITIALIZED This instance of the Exchange client has not been initialized.

It must be initialized using the IExchangeClient::Initialize method.

S_OK The request was submitted successfully.

Remarks

The results generated by this method contain the GAL results that meet the specified criteria. For more information about how the Exchange server responds to different criteria values, see GALSearchCriteria.

This method returns immediately.

When the IExchangeClientRequestCallback::OnRequestProgress method indicates that the request is complete by returning the e_ecrsSucceeded value, calling code can use the IExchangeClientRequest::GetDataItemArray method to retrieve the returned results.

Calling code can then call IExchangeClientDataItemArray::GetItemAt and then query the returned interface for the IExchangeClientGALSearchInformation interface.

Finally, calling code can use the methods in the IExchangeClientGALSearchInformation interface to retrieve GAL information.

For a list of steps necessary to retrieve information using this method, see Retrieving Information from an Exchange Server.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: IExchangeClient.h, IExchangeClient.idl.
Link Library: OWAExchangeClient.lib.

See Also

IExchangeClient | e_ecrsSucceeded | GALSearchCriteria | IExchangeClientDataItemArray::GetItemAt | IExchangeClientGALSearchInformation | IExchangeClientRequest | IExchangeClientRequest::GetDataItemArray | IExchangeClientRequestCallback::OnRequestProgress

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.