Funzione SetupInitializeFileLogA (setupapi.h)
[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.
La funzione SetupInitializeFileLog inizializza un file per registrare operazioni di installazione e risultati. Questo può essere il log di sistema, in cui il sistema tiene traccia dei file installati come parte di Windows o qualsiasi altro file.
Sintassi
WINSETUPAPI HSPFILELOG SetupInitializeFileLogA(
[in] PCSTR LogFileName,
[in] DWORD Flags
);
Parametri
[in] LogFileName
Puntatore facoltativo al nome file del file da usare come file di log. È consigliabile usare una stringa con terminazione Null. Il parametro LogFileName deve essere specificato se Flags non include SPFILELOG_SYSTEMLOG. Il parametro LogFileName non deve essere specificato se Flag include SPFILELOG_SYSTEMLOG. Questo parametro può essere NULL.
[in] Flags
Controlla l'inizializzazione del file di log. Questo parametro può essere una combinazione dei valori seguenti.
SPFILELOG_SYSTEMLOG
Usare il log dei file di sistema. L'utente deve essere un amministratore per specificare questa opzione a meno che non sia specificato SPFILELOG_QUERYONLY e LogFileName non sia specificato. Non specificare SPFILELOG_SYSTEMLOG in combinazione con SPFILELOG_FORCENEW.
SPFILELOG_FORCENEW
Se il file di log esiste, sovrascriverlo. Se il file di log esiste e questo flag non è specificato, tutti i nuovi file installati vengono aggiunti all'elenco nel file di log esistente. Non specificare in combinazione con SPFILELOG_SYSTEMLOG.
SPFILELOG_QUERYONLY
Aprire il file di log solo per eseguire query.
Valore restituito
La funzione restituisce l'handle al file di log se ha esito positivo. In caso contrario, il valore restituito è INVALID_HANDLE_VALUE e l'errore registrato può essere recuperato da una chiamata a GetLastError.
Commenti
Nota
L'intestazione setupapi.h definisce SetupInitializeFileLog come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | setupapi.h |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |