IStillImageW::GetSTILaunchInformation-Methode (sti.h)

Die IStillImage::GetSTILaunchInformation-Methode gibt den Grund zurück, aus dem die aufrufende Standbildanwendung gestartet wurde, wenn der Monitor des Standbildereignisses sie gestartet hat.

Syntax

HRESULT GetSTILaunchInformation(
  [out]           LPWSTR pwszDeviceName,
  [out, optional] DWORD  *pdwEventCode,
  [out]           LPWSTR pwszEventName
);

Parameter

[out] pwszDeviceName

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer STI_MAX_INTERNAL_NAME_LENGTH Bytes länge, um den internen Gerätenamen des Standbildgeräts zu empfangen, für das die Anwendung gestartet wurde.

[out, optional] pdwEventCode

Für die zukünftige Verwendung reserviert.

[out] pwszEventName

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der groß genug ist, um eine Zeichenfolgendarstellung einer GUID zu empfangen. Die GUID stellt die Standbildgeräteereignisse dar, für die die Anwendung gestartet wurde.

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

Wenn der Standbildereignismonitor die Anwendung gestartet hat, identifizieren die Werte pwszDeviceName und pwszEventName die Befehlszeilenargumente /StiDevice und /StiEvent (siehe Beschreibung von IStillImage::RegisterLaunchApplication). Wenn der Ereignismonitor die Anwendung nicht gestartet hat, gibt die Methode STIERR_GENERIC zurück.

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

Anforderungen