IWiaItem::EnumRegisterEventInfo method (wia_xp.h)

The IWiaItem::EnumRegisterEventInfo method creates an enumerator used to obtain information about events for which an application is registered.

Syntax

HRESULT EnumRegisterEventInfo(
  [in]  LONG              lFlags,
  [in]  const GUID        *pEventGUID,
  [out] IEnumWIA_DEV_CAPS **ppIEnum
);

Parameters

[in] lFlags

Type: LONG

Currently unused. Should be set to zero.

[in] pEventGUID

Type: const GUID*

Pointer to an identifier that specifies the hardware event for which you want registration information.

[out] ppIEnum

Type: IEnumWIA_DEV_CAPS**

Receives the address of a pointer to the IEnumWIA_DEV_CAPS interface.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

An application invokes this method to create an enumerator object for the event information. IWiaItem::EnumRegisterEventInfo stores the address of the IEnumWIA_DEV_CAPS interface of the enumerator object in the ppIEnum parameter. The program then uses the interface pointer to enumerate the properties of the event for which it is registered.

Each WIA_DEV_CAP structure includes an indication of whether the event is of type WIA_NOTIFICATION_EVENT or WIA_ACTION_EVENT or both.

Applications must call the IUnknown::Release method on the interface pointers they receive through the ppIEnum parameter.

Requirements