IExchangeClientGALSearchInformation (Windows Embedded CE 6.0)

1/6/2010

This interface provides properties from a single global address list (GAL) entry.

For detailed step-by-step instructions that demonstrate how to use this interface, see Retrieving Information from an Exchange Server.

Methods

The following table shows the methods for this interface in vtable order.

Like all COM interfaces, this interface inherits the methods for the IUnknown interface.

Method	Description
GetDisplayName	Provides the display name associated with the GAL entry.
GetPhoneNumber	Provides the phone number associated with the GAL entry.
GetAlias	Provides the alias associated with the GAL entry.
GetOffice	Provides the office information associated with the GAL entry.
GetSMTPAddress	Provides the SMTP address associated with the GAL entry.

To obtain a pointer to this interface, call IUnknown::QueryInterface on a reference returned by IExchangeClientDataItemArray::GetItemAt.

Only IExchangeClientDataItemArray instances generated by calls to IExchangeClient::RequestGALSearch can be used to retrieve references to this type of interface.

The steps necessary to obtain a pointer to an interface of this type are as follows:

Initiate a request for contact information using the IExchangeClient::RequestGALSearch method.
Wait until the request has completed successfully (as indicated by an e_ecrsSucceeded value in the second parameter of the IExchangeClientRequestCallback::OnRequestProgress method).
Call IExchangeClientRequest::GetDataItemArray to retrieve an array of the contact information returned by the Exchange server.
Using the IExchangeClientDataItemArray::GetItemCount and IExchangeClientDataItemArray::GetItemAt methods, retrieve an IUnknown reference for the data you want to access.
Call IUnknown::QueryInterface on the IUnknown reference to retrieve an IExchangeClientGALSearchInformation reference.

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