Chiamata a SetupWriteTextLog

SetupWriteTextLog aggiunge una singola voce con informazioni su un evento di installazione a un log di testo SetupAPI.

Come descritto in Formato di corpo di una sezione del log di testo, il formato di una voce di log è costituito dai campi seguenti:

entry_prefix time_stamp event_category indentation formatted_message

Per chiamare SetupWriteTextLog, un'applicazione fornisce le informazioni seguenti:

• Token di log per una sezione di un log di testo ottenuto chiamando SetupGetThreadLogToken o uno dei token di log definiti dal sistema. Se il token di log è associato a una sezione del log di testo, SetupWriteTextLog scrive la voce di log in tale sezione. In caso contrario, SetupWriteTextLog aggiunge la voce di log a una parte del log che non è inclusa in una sezione del log di testo. Inoltre, se SetupWriteTextLog scrive una voce di log e in cui il log di testo SetupWriteTextLog scrive la voce, dipende dal valore del token di log definito dal sistema.

  Per altre informazioni sui token di log, vedere Impostazione e recupero di un token di log per un thread.

• Una delle categorie di eventi descritte in Abilitazione delle categorie di eventi per un log di testo. Se la categoria di eventi per la voce è abilitata per il log di testo, SetupWriteTextLog aggiunge la voce al log di testo; in caso contrario, SetupWriteTextLog non scrive la voce nel log di testo.

• Valore del flag che è un OR bit per bit delle costanti definite dal sistema che specificano il livello dell'evento, la profondità di rientro e se includere un timestamp. I livelli di evento sono descritti in Impostazione del livello di evento per un log di testo. Se il livello di evento impostato per il log di testo è maggiore o uguale al livello di evento per la voce, SetupWriteTextLog scrive una voce di log nel log di testo; in caso contrario, SetupWriteTextLog non scrive una voce di log nel log di testo. Usando il rientro, i messaggi formattati possono essere disposti per semplificare la lettura e la comprensione delle informazioni in una sezione. Per altre informazioni, vedere Scrittura di voci di log rientrate.

• Stringa di formato compatibile con printf che formatta sia il messaggio che l'elenco di variabili separate da virgole che seguono la stringa di formato.

• Elenco delimitato da virgole di variabili, i cui valori sono formattati dalla stringa di formato compatibile con printf.

Per un esempio su come chiamare SetupWriteTextLog per registrare informazioni su un evento che non è un errore o un avviso, vedere Scrittura di una voce del log delle informazioni.

Per un esempio su come chiamare SetupWriteTextLog per registrare informazioni su un errore o un avviso, vedere Scrittura di un errore o voce di log degli avvisi.