RegisterLaunchApplication method

The IStillImage::RegisterLaunchApplication method puts an application in the Event Monitor's list of currently running applications that use the push model.

Syntax

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

Parameters

pwszAppName [in]

Pointer to a null-terminated string that contains the name of the application. This name is used in the Control Panel property sheet where you associate applications with device events.

pwszCommandLine [in]

Pointer to a null-terminated string that contains the full path to the executable file for this application. Additional command line arguments can be appended to this command. Two pairs of quotation marks should be used, for example, "\"C:\Program Files\MyExe.exe\" /arg1".

Return value

If the method succeeds, the return value is S_OK.

If the method fails, the return value is the appropriate COM error.

Remarks

This method must be called after an application is launched. It tells the Event Monitor to add the application to its list of currently running applications that use the push model.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Sti.h
Library
Sti.lib
DLL
Sti.dll

See also

About Still Image

Making an Application Still Image-Aware