IWiaDevMgr::RegisterEventCallbackProgram-Methode (wia_xp.h)

Die IWiaDevMgr::RegisterEventCallbackProgram-Methode registriert eine Anwendung, um Geräteereignisse zu empfangen. Es wird in erster Linie für die Abwärtskompatibilität mit Anwendungen bereitgestellt, die nicht für WIA geschrieben wurden.

Syntax

HRESULT RegisterEventCallbackProgram(
  [in] LONG       lFlags,
  [in] BSTR       bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in] BSTR       bstrCommandline,
  [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 sich die Anwendung registriert. Eine Liste der gültigen Ereignis-GUIDs finden Sie unter WIA-Ereignisbezeichner.

[in] bstrCommandline

Typ: BSTR

Gibt eine Zeichenfolge an, die den vollständigen Pfadnamen und die entsprechenden Befehlszeilenargumente enthält, die zum Aufrufen der Anwendung erforderlich sind. Es sollten zwei Paare von Anführungszeichen verwendet werden, z. B. "C:\Program Files\MyExe.exe" /arg1".

[in] bstrName

Typ: BSTR

Gibt den Namen der Anwendung an. Dieser Name wird dem Benutzer angezeigt, wenn sich mehrere Anwendungen für dasselbe Ereignis registrieren.

[in] bstrDescription

Typ: BSTR

Gibt die Beschreibung der Anwendung an. Diese Beschreibung wird dem Benutzer angezeigt, wenn sich mehrere Anwendungen für dasselbe Ereignis registrieren.

[in] bstrIcon

Typ: BSTR

Gibt das Symbol an, das die Anwendung darstellt. Das Symbol wird dem Benutzer angezeigt, wenn sich mehrere Anwendungen für dasselbe Ereignis registrieren. Die Zeichenfolge enthält den Namen der Anwendung und den 0-basierten Index des Symbols (es kann mehrere Symbole geben, die die Anwendung darstellen) durch ein Komma getrennt. Beispiel: "MyApp, 0".

Rückgabewert

Typ: HRESULT

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

Hinweise

Verwenden Sie IWiaDevMgr::RegisterEventCallbackProgram , um sich für Hardwaregeräteereignisse des Typs WIA_ACTION_EVENT zu registrieren. Wenn ein Ereignis auftritt, für das eine Anwendung registriert ist, wird die Anwendung gestartet, und die Ereignisinformationen werden an die Anwendung übertragen.

Anwendungen verwenden die EnumRegisterEventInfo-Methode , um einen Zeiger auf ein Enumeratorobjekt für Ereignisregistrierungseigenschaften abzurufen.

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

Programme sollten nur die IWiaDevMgr::RegisterEventCallbackProgram-Methode für die Abwärtskompatibilität mit Anwendungen verwenden, die nicht für die WIA-Architektur geschrieben wurden. Neue Anwendungen sollten die COM-Schnittstellen (Component Object Model) verwenden, die von der WIA-Architektur bereitgestellt werden. Insbesondere sollten sie IWiaDevMgr::RegisterEventCallbackInterface oder IWiaDevMgr::RegisterEventCallbackCLSID aufrufen, um sich für Geräteereignisse zu registrieren.

In der Regel wird diese Methode von einem Installationsprogramm oder einem Skript aufgerufen. Das Installationsprogramm oder Skript registriert die Anwendung, um WIA-Geräteereignisse zu empfangen. Wenn das Ereignis auftritt, wird die Anwendung vom WIA-Laufzeitsystem gestartet.

Anforderungen