Funzione SetupInitializeFileLogA (setupapi.h)

Articolo
03/05/2024

[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