IWiaItem2::EnumRegisterEventInfo-Methode

Die IWiaItem2::EnumRegisterEventInfo-Methode erstellt einen Enumerator, mit dem Sie Informationen zu Ereignissen abrufen können, für die eine Anwendung registriert ist.

Syntax

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

Parameter

lFlags [ In]

Typ: LONG

Nicht verwendet. Auf 0 festlegen.

pEventGUID [ In]

Typ: const * GUID

Zeiger auf einen Bezeichner, der das Hardwareereignis angibt, für das Sie Registrierungsinformationen abrufen möchten.

ppIEnum [ out]

Typ: IEnumWIA _ DEV _ CAPS**

Die Adresse eines Zeigers auf die IEnumWIA _ DEV _ CAPS-Schnittstelle.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Eine Anwendung ruft diese Methode auf, um ein Enumeratorobjekt für die Ereignisinformationen zu erstellen. IWiaItem2::EnumRegisterEventInfo speichert die Adresse der IEnumWIA _ DEV _ CAPS-Schnittstelle des Enumeratorobjekts im ppIEnum-Parameter. Das Programm verwendet dann den Schnittstellenzeiger, um die Eigenschaften des Ereignisses zu aufzählen, für das es registriert ist.

Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenze0er aufrufen, die sie über den ppIEnum-Parameter empfangen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Header
Wia.h