IExchangeClientDataItemArray::GetItemAt (Windows CE 5.0)
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