IExchangeClientDataItemArray::GetItemAt (Windows Embedded CE 6.0)

1/6/2010

This method provides the data item at the specified index.

Syntax

HRESULT GetItemAt(
  UINT idxItem,
  IUnknown** ppiItem
);

ppiItem
[out, retval] Pointer to a caller-supplied variable that this method uses to return a reference to an IUnknown instance that contains the data at the specified index.

This IUnknown reference can be queried for the actual data interface, as explained in the Remarks section that follows.

The following table shows possible return values:

Value	Description
E_POINTER	The address in ppiItem is not valid.
E_INVALIDARG	The index in idxItem is outside the range of the array.
S_OK	The number of items was returned successfully.

The IUnknown result in the ppiItem parameter can be queried, using IUnknown::QueryInterface, for the interface that represents the actual data.

The actual data interface, which differs depending on the type of request that generated the data array, then provides access to the returned data.

For example, if an array is associated with a response generated by a call to IExchangeClient::RequestContacts, the IUnknown interface provided in the ppiItem parameter can be queried for an instance of the IExchangeClientContactInformation interface.

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