IPhotoAcquireProgressCB::FoundItem method (photoacquire.h)

The FoundItem method provides extended functionality each time an item is found during enumeration of items from the device. This method can be used to exclude an item from the list of items to acquire. The application provides the implementation of the FoundItem method.

Syntax

HRESULT FoundItem(
  [in] IPhotoAcquireItem *pPhotoAcquireItem
);

Parameters

[in] pPhotoAcquireItem

Pointer to the found IPhotoAcquireItem object.

Return value

The method returns an HRESULT. Your implementation is not limited to the following return values. Any failing HRESULT other than E_NOTIMPL is fatal and will cause the transfer to abort.

Return code Description
S_OK
The method succeeded.
S_FALSE
Exclude this item from the list of files to acquire.

Remarks

Return S_FALSE to exclude the item from the results of the enumeration. This would allow the caller to exclude videos or camera raw files, for instance.

Requirements

Requirement Value
Target Platform Windows
Header photoacquire.h
Library PhotoAcquireUID.lib

See also

IPhotoAcquireProgressCB Interface