ISRResMerge::Merge

HRESULT Merge(LPUNKNOWN pIUnkAdjacent, PIUNKNOWN ppIUnkMerge);

Merges another speech-recognition results object with the current object so their data can be manipulated together.

· Returns NOERROR if successful, or one of these error values:

E_INVALIDARG
E_OUTOFMEMORY
SRERR_NOTENOUGHDATA
SRERR_NOTSUPPORTED
SRERR_VALUEOUTOFRANGE

pIUnkAdjacent

[in] Address of the IUnknown interface of the results object to merge with the current one.

ppIUnkMerge

[out] Address of a variable that receives a pointer to the IUnknown interface for the new results object created by the merge. The original results objects are not affected.

The two results objects must be temporally adjacent, or Merge returns an error.

Merging results objects is especially useful for obtaining more detailed information in a results graph.