Funzione SetupLogFileA (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 delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupLogFile aggiunge una voce al file di log.

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 come 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 una stringa con terminazione Null. 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 così come esiste nel supporto di origine da cui è stato installato. Questo nome deve essere in qualsiasi formato significativo per il chiamante. È consigliabile usare una stringa con terminazione Null.

[in] TargetFilename

Nome del file esistente nella destinazione. Questo nome deve essere in qualsiasi formato significativo per il chiamante. È consigliabile usare una stringa con terminazione Null.

[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 una stringa con terminazione Null. La stringa con terminazione Null non deve superare le dimensioni del buffer di destinazione. Ignorato per il log di sistema se non è 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 una stringa con terminazione Null. Ignorato per il log di sistema se SPFILELOG_OEMFILE non è specificato nel parametro Flags . Obbligatorio per il log di sistema se SPFILELOG_OEMFILE è specificato nel parametro Flags. In caso contrario, questo parametro può essere NULL.

[in] OtherInfo

Puntatore facoltativo a informazioni aggiuntive da associare al file. È consigliabile usare una stringa con terminazione Null. Questo parametro può essere NULL.

[in] Flags

Questo parametro può essere SPFILELOG_OEMFILE, che è 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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

Vedi anche

Funzioni

Panoramica

SetupRemoveFileLogEntry

Condividi tramite