Compartilhar via


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

O método IStillImage::WriteToErrorLog grava uma mensagem no log de erros de imagem ainda.

Sintaxe

HRESULT WriteToErrorLog(
       DWORD   dwMessageType,
  [in] LPCWSTR pszMessage
);

Parâmetros

dwMessageType

Valor constante fornecido pelo chamador que representa o tipo de mensagem. Os seguintes valores são definidos em Sti.h:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

[in] pszMessage

Ponteiro fornecido pelo chamador para a cadeia de caracteres de mensagem a ser gravada no arquivo de log.

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 arquivo de log de erros de imagem ainda é nomeado sti_trace.log e está localizado no diretório do Windows. Os valores do Registro determinam quais tipos de erro de imagem ainda (informativo, aviso ou erro) são gravados no log de erros (consulte Entradas do Registro Não Modificáveis).

As mensagens de erro devem ser reservadas para condições críticas de erro, como falhas de hardware do dispositivo. Mensagens informativas podem ser usadas para suas próprias finalidades de depuração. As mensagens registradas não são visíveis para os usuários, mas podem ser usadas por um engenheiro de suporte para ajudar a depurar os problemas de um usuário.

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