Share via

GALSearchCriteria (Windows Embedded CE 6.0)

  • Article

1/6/2010

This structure contains criteria submitted to Exchange when querying for information about an entity from the Exchange global address list (GAL).

You pass an instance of this structure to the IExchangeClient::RequestGALSearch method when initiating a search of the GAL.

Syntax

struct GALSearchCriteria {
  WCHAR* wszAlias;
  WCHAR* wszFirstName;
  WCHAR* wszLastName;
};

Members

  • wszAlias
    The email alias of the entity that GAL information should be returned for.

    For example, if an Exchange email address is myname@microsoft.com, the value for this parameter is myname.

  • wszFirstName
    The first name on which to search.
  • wszLastName
    The last name on which to search.

Remarks

A search using this structure returns records that start with the provided strings.

For example, if wszAlias is john, the search returns records that have an alias that starts with john, including john, johnd, johndoe, and so on.

Each field of the structure can point to a string that constrains the search, or the field can contain NULL if the field is not relevant for the search.

At least field of the structure must be non-null, or RequestGALSearch returns OWAEC_E_INVALIDSEARCH.

If more than one field points to a valid string, the search applies all criteria in an AND combination.

For example, if wszAlias is john and wszLastName is Doe, the search returns records that have an alias that starts with john and that have a last name that starts with Doe.

The search is case-insensitive.

Any search returns a maximum of 100 records. This is a behavior of the Exchange server and cannot be modified.

You can reduce the number of hits by providing more specific criteria.

You can experiment with queries by manually building and sending the same URLs as the Exchange Client.

For example, the following query returns all GAL entries that have the alias john, the first name John, and the last name Doe:

https://<Exchange server>/exchange/?cmd=galfind&an=john&fn=John&ln=Doe

Requirements

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

See Also

Reference

Exchange Client Structures
IExchangeClient::RequestGALSearch