IWiaDevMgr2::RegisterEventCallbackProgram-Methode

Die IWiaDevMgr2::RegisterEventCallbackProgram-Methode registriert eine Anwendung zum Empfangen von Geräteereignissen. Sie wird hauptsächlich aus Gründen der Abwärtskompatibilität mit Anwendungen bereitgestellt, die nicht für Windows Image Acquisition (WIA) 2.0 geschrieben wurden.

Syntax

HRESULT RegisterEventCallbackProgram(
  [in]       LONG lFlags,
  [in]       BSTR bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in]       BSTR bstrFullAppName,
  [in]       BSTR bstrCommandlineArg,
  [in]       BSTR bstrName,
  [in]       BSTR bstrDescription,
  [in]       BSTR bstrIcon
);

Parameter

lFlags [ In]

Typ: LONG

Die Registrierungsflags. Kann auf die folgenden Werte festgelegt werden.

Wert Bedeutung
WIA _ _ REGISTER-EREIGNISRÜCKRUF _
Registrieren Sie sich für das Ereignis.
WIA _ _ UNREGISTER-EREIGNISRÜCKRUF _
Löschen Sie die Registrierung für das Ereignis.
WIA _ SET _ DEFAULT _ HANDLER
Legen Sie die Anwendung als Standardereignishandler fest.

bstrDeviceID [ In]

Typ: BSTR

Eine Geräte-ID. Übergeben Sie NULL, um sich auf allen WIA 2.0-Geräten für das Ereignis zu registrieren.

pEventGUID [ In]

Typ: const * GUID

Das Ereignis, für das sich die Anwendung registriert. Eine Liste der gültigen Ereignis-GUIDs finden Sie unter WIA-Ereignisbezeichner.

bstrFullAppName [ In]

Typ: BSTR

Der vollständige Pfadname der Anwendung.

bstrCommandlineArg [ In]

Typ: BSTR

Die entsprechenden Befehlszeilenargumente für die Anwendung.

bstrName [ In]

Typ: BSTR

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

bstrDescription [ In]

Typ: BSTR

Die Beschreibung der Anwendung. Die Beschreibung wird dem Benutzer angezeigt, wenn sich mehrere Anwendungen für dasselbe Ereignis registrieren.

bstrIcon [ In]

Typ: BSTR

Das Symbol, 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 nullbasierten Index des Symbols, getrennt durch ein Komma, z. B. "MyApp, 0". Möglicherweise gibt es mehrere Symbole, die eine Anwendung darstellt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Verwenden Sie IWiaDevMgr2::RegisterEventCallbackProgram, um sich für Hardwaregeräteereignisse 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.

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

Verwenden Sie aus Gründen der Abwärtskompatibilität nur die IWiaDevMgr2::RegisterEventCallbackProgram-Methode mit Anwendungen, die nicht für die WIA 2.0-Architektur geschrieben wurden. Verwenden Sie Component Object Model -Schnittstellen (COM), die von der WIA 2.0-Architektur für neue Anwendungen bereitgestellt werden. Rufen Sie insbesondere IWiaDevMgr2::RegisterEventCallbackInterface oder IWiaDevMgr2::RegisterEventCallbackCLSID auf, um eine neue Anwendung für Geräteereignisse zu registrieren.

In der Regel wird diese Methode von einem Installationsprogramm oder skript aufgerufen. Das Installationsprogramm oder Skript registriert die Anwendung für den Empfang von WIA 2.0-Geräteereignissen. Wenn das Ereignis auftritt, wird die Anwendung vom WIA 2.0-Laufzeitsystem gestartet.

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