IWiaItem2::EnumRegisterEventInfo method

The IWiaItem2::EnumRegisterEventInfo method creates an enumerator that you can use 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

lFlags [in]

Type: LONG

Not used. Set to 0.

pEventGUID [in]

Type: const GUID*

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

ppIEnum [out]

Type: IEnumWIA_DEV_CAPS**

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 calls this method to create an enumerator object for the event information. IWiaItem2::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.

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

Requirements