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

El método IStillImage::GetSTILaunchInformation devuelve el motivo por el que se inició la aplicación de imagen que realiza la llamada, si el monitor de eventos de imagen fija lo inició.

Sintaxis

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

Parámetros

[out] pwszDeviceName

Puntero proporcionado por el autor de la llamada a un búfer, STI_MAX_INTERNAL_NAME_LENGTH bytes de longitud, para recibir el nombre interno del dispositivo de imagen para el que se inició la aplicación.

[out, optional] pdwEventCode

Reservado para uso futuro.

[out] pwszEventName

Puntero proporcionado por el autor de la llamada a un búfer lo suficientemente grande como para recibir una representación de cadena de un GUID. El GUID representa los eventos de dispositivo de imagen fija para los que se inició la aplicación.

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

Si el monitor de eventos de imagen fija inició la aplicación, los valores pwszDeviceName y pwszEventName identifican los argumentos de línea de comandos /StiDevice y /StiEvent (vea la descripción de IStillImage::RegisterLaunchApplication). Si el monitor de eventos no inició la aplicación, el método devuelve STIERR_GENERIC.

Antes de llamar a IStillImage::GetSTILaunchInformation, 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)