Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IWiaItem::EnumRegisterEventInfo method

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

lFlags [in]

Type: LONG

Currently unused. Should be set to zero.

pEventGUID [in]

Type: const GUID*

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

ppIEnum [out]

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

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wia.h

Library

Wiaguid.lib

DLL

Wiaservc.dll

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.