IExchangeClientContactInformation:IUnknown (Windows CE 5.0)

Send Feedback

This interface provides properties from a single contact record.

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

The methods in this interface represent the default set of contact information retrieved from the Exchange server. For information about changing the information retrieved from the Exchange server, say, to retrieve additional contact fields, see Modifying Returned Contact Information.

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 of the contact.
  GetHomePhoneNumber	Provides the home phone number of the contact.
  GetWorkPhoneNumber	Provides the work phone number of the contact.
  GetMobilePhoneNumber	Provides the mobile phone number of the contact.
  GetEmailAddress	Provides the email address of the contact.
  GetHomeAddress	Provides the home address of the contact.
  GetWorkAddress	Provides the work address of the contact.

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::RequestContacts 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::RequestContacts 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 IExchangeClientContactInformation 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::RequestContacts | 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.