Metodo IStillImageW::WriteToErrorLog (sti.h)

Il metodo IStillImage::WriteToErrorLog scrive un messaggio nel log degli errori di immagine ancora.

Sintassi

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

Parametri

dwMessageType

Valore costante fornito dal chiamante che rappresenta il tipo di messaggio. I valori seguenti sono definiti in Sti.h:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

[in] pszMessage

Puntatore fornito dal chiamante alla stringa di messaggio da scrivere nel file di log.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Il file di log degli errori di immagine ancora è denominato sti_trace.log e si trova nella directory di Windows. I valori del Registro di sistema determinano i tipi di errore dell'immagine (informazioni, avvisi o errori) vengono scritti nel log degli errori (vedere Voci del Registro di sistema non modificabili).

I messaggi di errore devono essere riservati a condizioni di errore critiche, ad esempio errori hardware del dispositivo. I messaggi informativi possono essere usati per scopi di debug personalizzati. I messaggi registrati non sono visibili agli utenti, ma potrebbero essere usati da un tecnico di supporto per consentire il debug dei problemi di un utente.

Prima di chiamare IStillImage::WriteToErrorLog, i client dell'interfaccia COM IStillImage devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore dell'interfaccia IStillImage.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	sti.h (include Sti.h)