Funzione SetupInitializeFileLogW (setupapi.h)
[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 SetupInitializeFileLog inizializza un file per registrare operazioni e risultati di installazione. Può trattarsi del log di sistema, in cui il sistema tiene traccia dei file installati come parte di Windows o di qualsiasi altro file.
Sintassi
WINSETUPAPI HSPFILELOG SetupInitializeFileLogW(
[in] PCWSTR LogFileName,
[in] DWORD Flags
);
Parametri
[in] LogFileName
Puntatore facoltativo al nome file del file da usare come file di log. È consigliabile usare un nullstringa con terminazione. Il parametro LogFileName deve essere specificato se Flags non include SPFILELOG_SYSTEMLOG. Il parametro
[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 venga specificata 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 viene 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 l'esecuzione di query.
Valore restituito
Se ha esito positivo, la funzione restituisce l'handle al file di log. In caso contrario, il valore restituito è INVALID_HANDLE_VALUE e l'errore registrato può essere recuperato da una chiamata a GetLastError.
Osservazioni
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 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 |