IStillImageW：：RegisterLaunchApplication 方法 （sti.h）

IStillImage：：RegisterLaunchApplication 方法将应用程序添加到静止图像事件监视器的推送模型感知应用程序列表。

语法

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

参数

[in] pwszAppName

调用方提供的指向表示应用程序的“短名称”的字符串的指针，扫描仪和相机控制面板的属性表将显示该字符串。

[in] pwszCommandLine

调用方提供的指向字符串的指针，该字符串表示启动应用程序所需的命令行，包括应用程序可执行文件的完整路径。 可以通过调用 GetModuleFileName（Microsoft Windows SDK 文档中所述）来获取当前路径。 有关详细信息，请参阅以下 备注 部分。

返回值

如果作成功，该方法将返回S_OK。 否则，它将返回在 stierr.h中定义的 STIERR 前缀错误代码之一。

言论

应用程序（或应用程序的安装程序）必须调用 IStillImage：：RegisterLaunchApplication，以便静止图像事件监视器知道其存在。 用户通过使用控制面板的属性表界面将 静止图像设备事件 与已注册的应用程序相关联。 用户与应用程序关联设备事件后，事件监视器将在事件发生时启动应用程序。

该方法在注册表中写入应用程序的加载路径。 因此，每次运行应用程序时都应调用该方法，因为用户可能移动了该文件，GetModuleFileName 始终返回当前文件位置。

可以在应用程序的命令行中包含命令参数。 启动已注册的应用程序时，事件监视器会将以下两个参数追加到命令行：

应用程序可以通过调用 IStillImage：：GetSTILaunchInformation来获取为这些参数指定的值。

在调用 IStillImage：：RegisterLaunchApplication之前，IStillImage COM 接口的客户端必须调用 IStillImage：：StiCreateInstance 以获取 IStillImage 接口指针。

要求