IExchangeClientContactInformation (Windows Embedded CE 6.0)
1/6/2010
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 |
|---|---|
Provides the display name of the contact. |
|
Provides the home phone number of the contact. |
|
Provides the work phone number of the contact. |
|
Provides the mobile phone number of the contact. |
|
Provides the email address of the contact. |
|
Provides the home address of the contact. |
|
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:
- Initiate a request for contact information using the IExchangeClient::RequestContacts 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 IExchangeClientContactInformation reference.
Requirements
| Header | iexchangeclient.h, iexchangeclient.idl |
| Library | OWAExchangeClient.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
See Also
Reference
Exchange Client Interfaces
IExchangeClient::RequestContacts
IExchangeClientDataItemArray
IExchangeClientDataItemArray::GetItemAt
IExchangeClientDataItemArray::GetItemCount
IExchangeClientRequest::GetDataItemArray
IExchangeClientRequestCallback::OnRequestProgress