Compartir a través de

Método IStillImageW::RegisterLaunchApplication (sti.h)

  • Artículo

El método IStillImage::RegisterLaunchApplication agrega una aplicación a la lista del monitor de eventos de imagen fija de aplicaciones compatibles con el modelo de inserción.

Sintaxis

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

Parámetros

[in] pwszAppName

Puntero proporcionado por el autor de la llamada a una cadena que representa el "nombre corto" de la aplicación, que se mostrarán los escáneres y las cámaras Panel de control hoja de propiedades.

[in] pwszCommandLine

Puntero proporcionado por el autor de la llamada a una cadena que representa la línea de comandos necesaria para iniciar la aplicación, incluida la ruta de acceso completa al archivo ejecutable de la aplicación. La ruta de acceso actual se puede obtener llamando a GetModuleFileName (que se describe en la documentación de Microsoft Windows SDK). Para obtener más información, vea la siguiente sección Comentarios .

Valor devuelto

Si la operación se realiza correctamente, el método devuelve S_OK. De lo contrario, devuelve uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Comentarios

Una aplicación (o el instalador de la aplicación) debe llamar a IStillImage::RegisterLaunchApplication para que el monitor de eventos de imagen todavía conozca su existencia. Los usuarios asocian Still Image Device Events con aplicaciones registradas mediante la interfaz de hoja de propiedades de Panel de control. Una vez que un usuario haya asociado un evento de dispositivo con la aplicación, el monitor de eventos iniciará la aplicación cuando se produzca el evento.

El método escribe la ruta de acceso de carga de la aplicación en el Registro. Por lo tanto, se debe llamar al método cada vez que se ejecuta la aplicación, ya que el usuario podría haber movido el archivo y GetModuleFileName siempre devuelve la ubicación del archivo actual.

Puede incluir argumentos de comando en la línea de comandos de la aplicación. Al iniciar una aplicación registrada, el monitor de eventos anexa los dos argumentos siguientes a la línea de comandos:

Argumento de línea de comandos Descripción
**/StiDevice:**InternalDeviceName InternalDeviceName es el nombre de dispositivo interno del dispositivo para el que se está iniciando la aplicación.
**/StiEvent:**EventGUID EventGUID es la representación de cadena del GUID para el evento de dispositivo que se ha producido.

La aplicación puede obtener los valores especificados para estos argumentos llamando a IStillImage::GetSTILaunchInformation.

Antes de llamar a IStillImage::RegisterLaunchApplication, los clientes de la interfaz COM IStillImage deben llamar a IStillImage::StiCreateInstance para obtener un puntero de interfaz IStillImage .

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado sti.h (include Sti.h)