iStillImageW：：RegisterLaunchApplication 方法 (sti.h)

IStillImage：：RegisterLaunchApplication 方法會將應用程式新增至仍然影像事件監視器的推播模型感知應用程式清單。

語法

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

參數

[in] pwszAppName

呼叫端提供的字串指標，代表應用程式的「簡短名稱」，掃描器和相機 控制台 的屬性表將會顯示。

[in] pwszCommandLine

呼叫端提供的字串指標，代表啟動應用程式所需的命令行，包括應用程式可執行檔的完整路徑。 呼叫 Microsoft Windows SDK 檔) 中所述的 GetModuleFileName (，即可取得目前的路徑。 如需詳細資訊，請參閱下列一節。

傳回值

如果作業成功，方法會傳回S_OK。 否則，它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。

備註

應用程式 (或應用程式的安裝程式) 必須呼叫 IStillImage：：RegisterLaunchApplication ，讓仍然的映像事件監視器知道其存在。 使用者會使用 控制台 的屬性表介面，將仍然影像裝置事件與已註冊的應用程式產生關聯。 使用者與應用程式建立關聯的裝置事件之後，事件監視器會在事件發生時啟動應用程式。

方法會在登錄中寫入應用程式的載入路徑。 因此，每次應用程式執行時都應該呼叫 方法，因為使用者可能已經移動檔案，而 GetModuleFileName 一律會傳回目前的檔案位置。

您可以在應用程式的命令列中包含命令自變數。 啟動已註冊的應用程式時，事件監視器會將下列兩個自變數附加至命令行：

命令行自變數	Description
**/StiDevice：**InternalDeviceName	InternalDeviceName 是啟動應用程式之裝置的內部裝置名稱。
**/StiEvent：**EventGUID	EventGUID 是發生之裝置事件的 GUID 字串表示。

應用程式可以藉由呼叫 IStillImage：：GetSTILaunchInformation 來取得這些自變數所指定的值。

在呼叫 IStillImage：：RegisterLaunchApplication 之前， IStillImage COM 介面的客戶端必須呼叫 IStillImage：：StiCreateInstance 以取得 IStillImage 介面指標。

規格需求

需求	值
目標平台	桌面
標頭	sti.h (包含 Sti.h)