IWiaItem::EnumRegisterEventInfo-Methode (wia_xp.h)

Die IWiaItem::EnumRegisterEventInfo-Methode erstellt einen Enumerator, mit dem Informationen zu Ereignissen abgerufen werden, für die eine Anwendung registriert ist.

Syntax

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

Parameter

[in] lFlags

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

[in] pEventGUID

Typ: const GUID*

Zeiger auf einen Bezeichner, der das Hardwareereignis angibt, für das Sie Registrierungsinformationen benötigen.

[out] ppIEnum

Typ: IEnumWIA_DEV_CAPS**

Empfängt 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 Fehlercode HRESULT zurückgegeben.

Hinweise

Eine Anwendung ruft diese Methode auf, um ein Enumeratorobjekt für die Ereignisinformationen zu erstellen. IWiaItem::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.

Jede WIA_DEV_CAP Struktur enthält einen Hinweis darauf, ob das Ereignis vom Typ WIA_NOTIFICATION_EVENT oder WIA_ACTION_EVENT oder beides ist.

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

Anforderungen