Share via


IExchangeClientDataItemArray::GetItemAt (Windows CE 5.0)

Send Feedback

This method provides the data item at the specified index.

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

Parameters

  • idxItem
    [in] Number that specifies the index of the data item to retrieve.

  • 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.

Return Values

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.

Remarks

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.

Requirements

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

See Also

IExchangeClientDataItemArray | IExchangeClientContactInformation | IExchangeClient::RequestContacts | IUnknown | IUnknown::QueryInterface

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.