GALSearchCriteria (Windows CE 5.0)
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.
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
OS Versions: Windows CE 5.0 and later.
Header: IExchangeClient.h, IExchangeClient.idl.
See Also
Exchange Client Structures | IExchangeClient::RequestGALSearch
Send Feedback on this topic to the authors