IWiaDevMgr::RegisterEventCallbackCLSID-Methode (wia_xp.h)

Die IWiaDevMgr::RegisterEventCallbackCLSID-Methode registriert eine Anwendung, um Ereignisse zu empfangen, auch wenn die Anwendung möglicherweise nicht ausgeführt wird.

Syntax

HRESULT RegisterEventCallbackCLSID(
  [in] LONG       lFlags,
  [in] BSTR       bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in] const GUID *pClsID,
  [in] BSTR       bstrName,
  [in] BSTR       bstrDescription,
  [in] BSTR       bstrIcon
);

Parameter

[in] lFlags

Typ: LONG

Gibt Registrierungsflags an. Kann auf die folgenden Werte festgelegt werden:

[in] bstrDeviceID

Typ: BSTR

Gibt einen Gerätebezeichner an. Übergeben Sie NULL , um sich für das Ereignis auf allen WIA-Geräten zu registrieren.

[in] pEventGUID

Typ: const GUID*

Gibt das Ereignis an, für das die Anwendung registriert wird. Eine Liste der Standardereignisse finden Sie unter WIA-Ereignisbezeichner.

[in] pClsID

Typ: const GUID*

Zeiger auf die Klassen-ID (CLSID) der Anwendung. Das WIA-Laufzeitsystem verwendet die CLSID der Anwendung, um die Anwendung zu starten, wenn ein Ereignis auftritt, für das sie registriert ist.

[in] bstrName

Typ: BSTR

Gibt den Namen der Anwendung an, die sich für das Ereignis registriert.

[in] bstrDescription

Typ: BSTR

Gibt eine Textbeschreibung der Anwendung an, die sich für das Ereignis registriert.

[in] bstrIcon

Typ: BSTR

Gibt den Namen einer Bilddatei an, die für das Symbol für die Anwendung verwendet werden soll, die sich für das Ereignis registriert.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

WIA-Anwendungen verwenden diese Methode, um Hardwaregeräteereignisse des Typs WIA_ACTION_EVENT zu empfangen. Sobald Programme IWiaDevMgr::RegisterEventCallbackCLSID aufrufen, werden sie registriert, um WIA-Geräteereignisse zu empfangen, auch wenn sie nicht ausgeführt werden.

Wenn das Ereignis auftritt, bestimmt das WIA-System, welche Anwendung registriert ist, um das Ereignis zu empfangen. Es verwendet die CoCreateInstance-Funktion und die im pClsID-Parameter angegebene Klassen-ID, um eine instance der Anwendung zu erstellen. Anschließend wird die ImageEventCallback-Methode der Anwendung aufgerufen, um die Ereignisinformationen zu übertragen.

Eine Anwendung kann die EnumRegisterEventInfo-Methode aufrufen, um Ereignisregistrierungsinformationen aufzulisten.

Eine Anwendung kann ermitteln, ob ein Ereignis ein Aktionstyp- oder Benachrichtigungstypereignis (oder beides) ist, indem sie den ulFlags-Wert einer WIA_DEV_CAP Struktur untersucht, die von der Ereignisenumeration zurückgegeben wird.

Wenn die Anwendung keine registrierte COM-Komponente (Component Object Model) ist und nicht mit der WIA-Architektur kompatibel ist, sollten Entwickler anstelle dieser Methode IWiaDevMgr::RegisterEventCallbackProgram verwenden.

Anforderungen