IExchangeClientGALSearchInformation:IUnknown (Windows CE 5.0)

Send Feedback

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.

Obtaining a Pointer

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:

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

Requirements

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

See Also

Exchange Client Interfaces | IExchangeClient::RequestGALSearch | IExchangeClientDataItemArray | IExchangeClientDataItemArray::GetItemAt | IExchangeClientDataItemArray::GetItemCount | IExchangeClientRequest::GetDataItemArray | IExchangeClientRequestCallback::OnRequestProgress | IUnknown | IUnknown::QueryInterface

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.