User's Manual Part 1

Scanner SupportChapter —6

152 700 Series Color Mobile Computer User’s Manual

IADC::CancelReadRequest

This function cancels a pending Read() request. This call can be made on a

separate thread as a Read() or on the same thread. On a separate thread,

the function is useful in unblocking a blocked Read() so that other opera-

tions can be performed. On the same thread, this function is useful in

stopping data from being collected on behalf of a Read Ahead Client.

Syntax

HRESULT IADC::CancelReadRequest( BOOL FlushBufferedData,WORD

*pwTotalDiscardedMessages, DWORD *pdwTotalDiscardedBytes );

Parameters

FlushBufferedData [in] True Flush and discard all already

buffered data.

False Do not discard data, data will be

returned on the next read call.

pwTotalDiscardedMessages [in/out] Total number of discarded buffered

labels or tags.

pdwTotalDiscardedBytes Total number of discarded bytes.

Return Values

HRESULT that indicates success or failure.

Remarks

The return value indicates whether a read was pending.