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

O método IStillImage::LaunchApplicationForDevice inicia um aplicativo especificado para um dispositivo de imagem ainda especificado.

Sintaxe

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

Parâmetros

[in] pwszDeviceName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa um nome de dispositivo interno, obtido chamando IStillImage::GetSTILaunchInformation ou IStillImage::GetDeviceList.

[in] pwszAppName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa o nome curto de um aplicativo que foi registrado chamando IStillImage::RegisterLaunchApplication.

[in] pStiNotify

Ponteiro fornecido pelo chamador para uma estrutura STINOTIFY que descreve um evento de dispositivo. Normalmente, o GUID do evento é obtido chamando IStiDevice::GetLastNotificationData.

Retornar valor

Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

O método IStillImage::LaunchApplicationForDevice só pode iniciar aplicativos que se registraram chamando IStillImage::RegisterLaunchApplication. O evento especificado deve ser aquele que o dispositivo especificado dá suporte. O método imita a ocorrência de um evento de dispositivo e é útil para aplicativos que interceptam eventos de dispositivos e os redirecionam. Quando um usuário inicia o scanner, esse aplicativo pode, por exemplo, perguntar ao usuário se ele deseja armazenar a imagem digitalizada, fazer uma cópia ou enviar um fax.

Antes de chamar IStillImage::LaunchApplicationForDevice, os clientes da interface COM IStillImage devem chamar IStillImage::StiCreateInstance para obter um ponteiro de interface IStillImage .

Exemplos

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
Plataforma de Destino	Área de Trabalho
Cabeçalho	sti.h (inclua Sti.h)