Funzione SetupWriteTextLogError (setupapi.h)

La funzione SetupWriteTextLogError scrive informazioni su un errore specifico di SetupAPI o un errore di sistema Win32 in un log di testo SetupAPI.

Sintassi

WINSETUPAPI VOID SetupWriteTextLogError(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Category,
  [in] DWORD        LogFlags,
  [in] DWORD        Error,
  [in] PCSTR        MessageStr,
       ...          
);

Parametri

[in] LogToken

Token di log che è un token di log definito dal sistema o restituito da SetupGetThreadLogToken.

[in] Category

Valore di tipo DWORD che indica la categoria di eventi per la voce di log. Le categorie di eventi che possono essere specificate per una voce di log sono uguali a quelle che possono essere abilitate per un log di testo. Per un elenco di categorie di eventi, vedere Abilitazione delle categorie di eventi per un log di testo SetupAPI.

[in] LogFlags

Valore di tipo DWORD che è un or bit per bit dei valori del flag, che specificano quanto segue:

• Livello di evento per la voce del log. I livelli di evento che possono essere specificati per una voce di log sono uguali a quelli che possono essere abilitati per un log di testo. Per un elenco di flag a livello di evento, vedere Impostazione del livello di evento per un log di testo.
• Indica se includere un timestamp nella voce del log. Il valore del flag timestamp è TXTLOG_TIMESTAMP.
• La modifica, se presente, alla profondità di rientro della sezione e alla voce del log corrente. Per informazioni su come usare i flag di rientro, vedere Scrittura di voci di log con rientro.

[in] Error

Codice di errore specifico di SetupAPI o codice di errore Win32. I codici di errore specifici di SetupAPI sono elencati in Setupapi.h. I codici di errore Win32 sono elencati in Winerror.h.

[in] MessageStr

Puntatore a una stringa costante con terminazione NULL contenente una stringa di formato compatibile con printf, che specifica il messaggio formattato da includere nella voce di log.

...

Elenco di parametri delimitati da virgole che corrispondono agli identificatori di formato nella stringa di formato fornita da MessageStr.

Valore restituito

nessuno

Osservazioni

Se un'applicazione di installazione ha un codice di errore specifico di SetupAPI o un codice di errore Win32 associato a un errore di installazione, l'applicazione può chiamare SetupWriteTextLogError anziché SetupWriteTextLog per scrivere due voci in un log di testo. La prima voce sarà uguale a quella scritta da SetupWriteTextLog e la seconda voce registrerà il codice di errore e una descrizione descrittiva dell'errore.

Il token di log, la categoria di eventi e i flag forniti da un chiamante influiscono sull'operazione di SetupWriteTextLogError è uguale a quello descritto per SetupWriteTextLog.

SetupWriteTextLogError scrive la prima voce di log nel formato seguente:

prefisso vocetime_stamp categoriain rientro formattato-message

SetupWriteTextLogError scrive la seconda voce di log nel formato seguente:

entry-prefixtime_stampcategoryindentationError:error-numbererror-description

Dove:

• I campi voce-prefissi, timestamp, categoria, rientro e messaggio formattato sono uguali a quelli descritti in Formato di un corpo della sezione Log di testo.
• Il campo numero di errore contiene il numero di errore.
• Il campo error-description contiene una descrizione descrittiva dell'errore.

Per informazioni generali sulla scrittura di voci di log nei log di testo SetupAPI, vedere SetupAPI Logging (Windows Vista).

Per altre informazioni sull'operazione di SetupWriteTextLogError, vedere Chiamata di SetupWriteTextLogError.

Per altre informazioni sui token di log, vedere Token di log.

Per altre informazioni sull'uso dei token di log, vedere Impostazione e recupero di un token di log per un thread.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	setupapi.h (includere Setupapi.h)
Libreria	Setupapi.lib

Vedi anche

SetupGetThreadLogToken

SetupWriteTextLog