Compartilhar via


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

O método IStillImage::GetSTILaunchInformation retorna o motivo pelo qual o aplicativo de imagem ainda chamada foi iniciado, se o monitor de eventos de imagem ainda o iniciou.

Sintaxe

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

Parâmetros

[out] pwszDeviceName

Ponteiro fornecido pelo chamador para um buffer, STI_MAX_INTERNAL_NAME_LENGTH bytes de comprimento, para receber o nome interno do dispositivo de imagem parada para o qual o aplicativo foi iniciado.

[out, optional] pdwEventCode

Reservado para uso futuro.

[out] pwszEventName

Ponteiro fornecido pelo chamador para um buffer grande o suficiente para receber uma representação de cadeia de caracteres de um GUID. O GUID representa os Eventos de Dispositivo de Imagem Ainda para os quais o aplicativo foi iniciado.

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

Se o monitor de eventos de imagem ainda tiver iniciado o aplicativo, os valores pwszDeviceName e pwszEventName identificarão os argumentos de linha de comando /StiDevice e /StiEvent (consulte a descrição de IStillImage::RegisterLaunchApplication). Se o monitor de eventos não tiver iniciado o aplicativo, o método retornará STIERR_GENERIC.

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