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 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 |