Condividi tramite

Scrittura di una voce del log delle informazioni

  • Articolo

Nell'esempio seguente viene illustrato come un'applicazione potrebbe in genere chiamare SetupWriteTextLog per scrivere una voce di informazioni in un log di testo SetupAPI che non è un messaggio di avviso o un messaggio di errore.

Per informazioni sulla chiamata a SetupWriteTextLog per registrare un messaggio di errore, vedere Chiamata di SetupWriteTextLog per registrare un errore o una voce di avviso.

L'applicazione chiama SetupWriteTextLog, fornendo i valori dei parametri seguenti:

  • LogToken è impostato su un valore del token di log ottenuto chiamando SetupGetThreadLogToken o è uno dei valori del token di log definiti dal sistema descritti nei token di log.

  • La categoria è impostata su TXTLOG_VENDOR, che indica che la voce di log viene effettuata da un'applicazione fornita dal fornitore. Le categorie di eventi sono descritte in Abilitazione delle categorie di eventi per un log di testo.

  • Flags è impostato su un OR bit per bit di TXTLOG_DETAILS e TXTLOG_TIMESTAMP. In questo esempio, la profondità del rientro non viene modificata e la profondità del rientro corrente è stata precedentemente impostata su cinque spazi di testo monospace. Per informazioni su come modificare la profondità di rientro, vedere Scrittura di voci di log rientrate. I livelli di evento sono descritti nell'argomento Impostazione del livello di evento per un log di testo .

  • MessageStr è impostato su TEXT("Variabile di interesse: = %d").

  • L'elenco di parametri delimitati da virgole fornisce la variabile SomeVariable, che corrisponde al campo "%d" in MessageStr.

//The LogToken value was previously returned by call to
//SetupGetThreadLogToken or one of the system-defined log token values
DWORD Category = TXTLOG_VENDOR; 
DWORD Flags = TXTLOG_DETAILS | TXTLOG_TIMESTAMP;
DWORD SomeVariable = 1;   // The variable whose value will be logged

SetupWriteTextLog(LogToken, Category, Flags, TEXT("Variable of interest: = %d"), SomeVariable);

Se la categoria di eventi TXTLOG_VENDOR è abilitata e il livello di evento TXTLOG_DETAILS è impostato per il log di testo dell'installazione del dispositivo, questo codice creerebbe una voce nel log di installazione del dispositivo nel formato seguente, in cui il timestamp verrebbe sostituito da un timestamp effettivo.

     2005/02/13 22:06:28.109:    :  Variable of interest: Abc = 1