Fonction SetupInitializeFileLogA (setupapi.h)

Article
03/01/2024

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour l’installation d’applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour l’installation des pilotes de périphérique.]

La fonction SetupInitializeFileLog initialise un fichier pour enregistrer les opérations d’installation et les résultats. Il peut s’agir du journal système, où le système effectue le suivi des fichiers installés dans le cadre de Windows, ou de tout autre fichier.

Syntaxe

WINSETUPAPI HSPFILELOG SetupInitializeFileLogA(
  [in] PCSTR LogFileName,
  [in] DWORD Flags
);

Paramètres

[in] LogFileName

Pointeur facultatif vers le nom du fichier à utiliser comme fichier journal. Vous devez utiliser une chaîne terminée par null. Le paramètre LogFileName doit être spécifié si Flags n’inclut pas SPFILELOG_SYSTEMLOG. Le paramètre LogFileName ne doit pas être spécifié si Flags inclut SPFILELOG_SYSTEMLOG. Ce paramètre peut être NULL.

[in] Flags

Contrôle l’initialisation du fichier journal. Ce paramètre peut être une combinaison des valeurs suivantes.

SPFILELOG_SYSTEMLOG

Utilisez le journal des fichiers système. L’utilisateur doit être administrateur pour spécifier cette option, sauf si SPFILELOG_QUERYONLY est spécifié et que LogFileName n’est pas spécifié. Ne spécifiez pas SPFILELOG_SYSTEMLOG en combinaison avec SPFILELOG_FORCENEW.

SPFILELOG_FORCENEW

Si le fichier journal existe, remplacez-le. Si le fichier journal existe et que cet indicateur n’est pas spécifié, tous les nouveaux fichiers installés sont ajoutés à la liste dans le fichier journal existant. Ne spécifiez pas en combinaison avec SPFILELOG_SYSTEMLOG.

SPFILELOG_QUERYONLY

Ouvrez le fichier journal pour l’interrogation uniquement.

Valeur retournée

La fonction retourne le handle au fichier journal si elle réussit. Sinon, la valeur de retour est INVALID_HANDLE_VALUE et l’erreur journalisée peut être récupérée par un appel à GetLastError.

Remarques

Notes

L’en-tête setupapi.h définit SetupInitializeFileLog comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	setupapi.h
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll