Funzione SetupLogFileA (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 SetupLogFile
Sintassi
WINSETUPAPI BOOL SetupLogFileA(
[in] HSPFILELOG FileLogHandle,
[in] PCSTR LogSectionName,
[in] PCSTR SourceFilename,
[in] PCSTR TargetFilename,
[in] DWORD Checksum,
[in] PCSTR DiskTagfile,
[in] PCSTR DiskDescription,
[in] PCSTR OtherInfo,
[in] DWORD Flags
);
Parametri
[in] FileLogHandle
Gestire il log del file restituito da SetupInitializeFileLog. Il chiamante non deve aver passato SPFILELOG_QUERYONLY quando il file di log è stato inizializzato.
[in] LogSectionName
Puntatore facoltativo al nome per un raggruppamento logico di nomi all'interno del file di log. È consigliabile usare un nullstringa con terminazione. Obbligatorio se SPFILELOG_SYSTEMLOG non è stato passato quando il log del file è stato inizializzato. In caso contrario, questo parametro può essere NULL.
[in] SourceFilename
Nome del file esistente nel supporto di origine da cui è stato installato. Questo nome deve essere in qualsiasi formato significativo per il chiamante. È consigliabile usare un nullstringa con terminazione.
[in] TargetFilename
Nome del file esistente nella destinazione. Questo nome deve essere in qualsiasi formato significativo per il chiamante. È consigliabile usare un nullstringa con terminazione.
[in] Checksum
Puntatore facoltativo a un valore di checksum. Obbligatorio per il log di sistema.
[in] DiskTagfile
Puntatore facoltativo al tagfile per il supporto da cui è stato installato il file. È consigliabile usare un nullstringa con terminazione. Il nullstringa con terminazione non deve superare le dimensioni del buffer di destinazione. Ignorato per il log di sistema se non viene specificato SPFILELOG_OEMFILE. Obbligatorio per il log di sistema se viene specificato SPFILELOG_OEMFILE. In caso contrario, questo parametro può essere NULL.
[in] DiskDescription
Puntatore facoltativo alla descrizione leggibile del supporto da cui è stato installato il file. È consigliabile usare un nullstringa con terminazione. Ignorato per il log di sistema se SPFILELOG_OEMFILE non è specificato nel parametro Flag
[in] OtherInfo
Puntatore facoltativo a informazioni aggiuntive da associare al file. È consigliabile usare un nullstringa con terminazione. Questo parametro può essere NULL.
[in] Flags
Questo parametro può essere SPFILELOG_OEMFILE, significativo solo per il log di sistema e indica che il file non è fornito da Microsoft. Questo parametro può essere usato per convertire la voce di un file esistente, ad esempio quando un OEM sovrascrive un file di sistema fornito da Microsoft.
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
Nota
L'intestazione setupapi.h definisce SetupLogFile 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 |