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

O método IStillImage::RegisterLaunchApplication adiciona um aplicativo à lista de aplicativos com reconhecimento de modelo de push do monitor de eventos ainda imagem.

Sintaxe

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

Parâmetros

[in] pwszAppName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa o "nome curto" do aplicativo, que a folha de propriedades scanners e câmeras Painel de Controle exibirá.

[in] pwszCommandLine

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa a linha de comando necessária para iniciar o aplicativo, incluindo o caminho completo para o arquivo executável do aplicativo. O caminho atual pode ser obtido chamando GetModuleFileName (descrito na documentação do SDK do Microsoft Windows). Para obter mais informações, consulte a seção Comentários a seguir.

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

Um aplicativo (ou o instalador do aplicativo) deve chamar IStillImage::RegisterLaunchApplication para que o monitor de eventos de imagem ainda saiba de sua existência. Os usuários associam eventos de dispositivo still image a aplicativos registrados usando a interface da folha de propriedades do Painel de Controle. Depois que um usuário associar um evento de dispositivo ao aplicativo, o monitor de eventos iniciará o aplicativo quando o evento ocorrer.

O método grava o caminho de carga do aplicativo no registro. Portanto, o método deve ser chamado sempre que o aplicativo for executado, pois o usuário pode ter movido o arquivo e GetModuleFileName sempre retorna o local do arquivo atual.

Você pode incluir argumentos de comando na linha de comando do aplicativo. Ao iniciar um aplicativo registrado, o monitor de eventos acrescenta os dois seguintes argumentos à linha de comando:

Argumento de linha de comando	Descrição
**/StiDevice:**InternalDeviceName	InternalDeviceName é o nome interno do dispositivo para o qual o aplicativo está sendo iniciado.
**/StiEvent:**EventGUID	EventGUID é a representação de cadeia de caracteres do GUID para o evento do dispositivo que ocorreu.

O aplicativo pode obter os valores especificados para esses argumentos chamando IStillImage::GetSTILaunchInformation.

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

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	sti.h (inclua Sti.h)