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

El método IStillImage::LaunchApplicationForDevice inicia una aplicación especificada para un dispositivo de imagen todavía especificado.

Sintaxis

HRESULT LaunchApplicationForDevice(
  [in] LPWSTR      pwszDeviceName,
  [in] LPWSTR      pwszAppName,
  [in] LPSTINOTIFY pStiNotify
);

Parámetros

[in] pwszDeviceName

Puntero proporcionado por el autor de la llamada a una cadena que representa un nombre de dispositivo interno, obtenido llamando a IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.

[in] pwszAppName

Puntero proporcionado por el autor de la llamada a una cadena que representa el nombre corto de una aplicación registrada llamando a IStillImage::RegisterLaunchApplication.

[in] pStiNotify

Puntero proporcionado por el autor de la llamada a una estructura de STINOTIFY que describe un evento de dispositivo. Normalmente, el GUID del evento se obtiene llamando a IStiDevice::GetLastNotificationData.

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.

Observaciones

El método IStillImage::LaunchApplicationForDevice solo puede iniciar aplicaciones que se hayan registrado llamando a IStillImage::RegisterLaunchApplication. El evento especificado debe ser uno que admita el dispositivo especificado. El método imita la aparición de un evento de dispositivo y es útil para las aplicaciones que interceptan eventos de dispositivos y los vuelven a enrutar. Cuando un usuario inicia el escáner, tal aplicación podría, por ejemplo, preguntar al usuario si desea almacenar la imagen escaneada, realizar una copia o enviar un fax.

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

Ejemplos

HRESULT hRes;
hRes = pStiDevice->GetLastNotificationData(&pNotify);
if (!SUCCEEDED(hRes))
{
    DisplayOutput("->GetLastNotificationData returned %xh %u",
        hReturn,hReturn);
}

// Process or filter events here

// Send event on to app
hRes = pSti->LaunchApplicationForDevice(pStiInfoPtr->szDeviceInternalName,
     L"AppName",
     pNotify);
if (!SUCCEEDED(hRes))
{
    DisplayOutput("->LaunchApplicationForDevice on %S returned %xh %u",
        pStiInfoPtr->szDeviceInternalName,hReturn,hReturn);
}

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	sti.h (include Sti.h)