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 |
|