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

Artigo
02/07/2025

O método IStillImage::GetSTILaunchInformation retorna o motivo pelo qual o aplicativo de imagem ainda de 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

O ponteiro fornecido pelo chamador para um buffer, STI_MAX_INTERNAL_NAME_LENGTH bytes de comprimento, para receber o nome interno do dispositivo de imagem ainda 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 o de Eventos de Dispositivo de Imagem Morta para o qual o aplicativo foi iniciado.

Valor de retorno

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.

Observações

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 argumentos de linha de comando (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 IStillImage COM devem chamar IStillImage::StiCreateInstance para obter um ponteiro de interface IStillImage.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	sti.h (inclua Sti.h)

Compartilhar via