Freigeben über


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, gibt sie S_OK zurück. 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 aufzulisten, für das es registriert ist.

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

Anforderungen

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