IStillImageW::RegisterLaunchApplication-Methode (sti.h)

Artikel
03/13/2023

Die IStillImage::RegisterLaunchApplication-Methode fügt der Liste der Pushmodell-fähigen Anwendungen des Ereignismonitors für Standbilder eine Anwendung hinzu.

Syntax

HRESULT RegisterLaunchApplication(
  [in] LPWSTR pwszAppName,
  [in] LPWSTR pwszCommandLine
);

Parameter

[in] pwszAppName

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die den "kurzen Namen" der Anwendung darstellt, der im Eigenschaftenblatt scanners and Cameras Systemsteuerung angezeigt wird.

[in] pwszCommandLine

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die die zum Starten der Anwendung erforderliche Befehlszeile darstellt, einschließlich des vollständigen Pfads zur ausführbaren Datei der Anwendung. Der aktuelle Pfad kann abgerufen werden, indem Sie GetModuleFileName aufrufen (in der Microsoft Windows SDK-Dokumentation beschrieben). Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise" .

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.

Hinweise

Eine Anwendung (oder das Installationsprogramm der Anwendung) muss IStillImage::RegisterLaunchApplication aufrufen, damit der Monitor des Standbildereignisses von seiner Existenz weiß. Benutzer zuordnen Standbildgeräteereignisse mit registrierten Anwendungen mithilfe der Eigenschaftenblattschnittstelle von Systemsteuerung. Nachdem ein Benutzer der Anwendung ein Geräteereignis zugeordnet hat, startet der Ereignismonitor die Anwendung, wenn das Ereignis eintritt.

Die -Methode schreibt den Ladepfad der Anwendung in die Registrierung. Daher sollte die Methode jedes Mal aufgerufen werden, wenn die Anwendung ausgeführt wird, da der Benutzer die Datei möglicherweise verschoben hat und GetModuleFileName immer den aktuellen Dateispeicherort zurückgibt.

Sie können Befehlsargumente in die Befehlszeile der Anwendung einschließen. Beim Starten einer registrierten Anwendung fügt der Ereignismonitor die folgenden beiden Argumente an die Befehlszeile an:

Befehlszeilenargument	BESCHREIBUNG
/StiDevice:InternalDeviceName	InternalDeviceName ist der interne Gerätename des Geräts, für das die Anwendung gestartet wird.
/StiEvent:EventGUID	EventGUID ist die Zeichenfolgendarstellung der GUID für das aufgetretene Geräteereignis.

Die Anwendung kann die für diese Argumente angegebenen Werte abrufen, indem sie IStillImage::GetSTILaunchInformation aufruft.

Vor dem Aufrufen von IStillImage::RegisterLaunchApplication müssen Clients der IStillImage-COM-Schnittstelle IStillImage::StiCreateInstance aufrufen, um einen IStillImage-Schnittstellenzeiger abzurufen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	sti.h (einschließlich Sti.h)

Freigeben über