Funzione SetupLogErrorW (setupapi.h)

Articolo
11/20/2024

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupLogError scrive un messaggio di errore in un file di log. È progettato per essere usato durante l'installazione di Windows, ma è sempre disponibile. Non deve essere usato dopo l'installazione del sistema operativo. Il registro eventi deve essere invece usato.

Sintassi

WINSETUPAPI BOOL SetupLogErrorW(
  [in] LPCWSTR     MessageString,
  [in] LogSeverity Severity
);

Parametri

[in] MessageString

Puntatore alla stringa che deve essere salvata nel log del programma di installazione. Il messaggio deve terminare con una combinazione di avanzamento riga restituita (\r\n). È consigliabile usare una stringa con terminazione Null. La stringa con terminazione Null non deve superare le dimensioni del buffer di destinazione. Il messaggio viene sempre salvato nel log azioni setupact.log. Se gravità è LogSevWarning, LogSevErroro LogSevFatalError, il programma di installazione salva anche il messaggio nel log degli errori setuperr.log. Entrambi i log vengono archiviati nella directory di Windows.

[in] Severity

Gravità del messaggio, uno dei seguenti: LogSevInformation, LogSevWarning, LogSevErroro LogSevFatalError.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Il log azioni è destinato alla registrazione di tutte le modifiche apportate al sistema durante l'installazione di Windows.
Il log degli errori è destinato agli errori solo durante l'installazione di Windows.
Il parametro MessageString può essere formattato ulteriormente dal programma di installazione ( anche se non esegue ora ulteriori elaborazioni).
Il log degli errori verrà presentato all'utente alla fine della configurazione del sistema.

Nota

L'intestazione setupapi.h definisce SetupLogError come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	setupapi.h
libreria	Setupapi.lib
dll	Setupapi.dll
set di API	ext-ms-win-setupapi-logging-l1-1-0 (introdotto in Windows 8)

Vedere anche

Funzioni

panoramica

Condividi tramite