SetupInitializeFileLogA, fonction (setupapi.h)
[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer 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 null-terminated. Le paramètre LogFileName doit être spécifié si indicateurs n’inclut pas SPFILELOG_SYSTEMLOG. Le paramètre LogFileName ne doit pas être spécifié si indicateurs 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 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é, 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 de retour
La fonction retourne le handle au fichier journal s’il 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
Note
L’en-tête setupapi.h définit SetupInitializeFileLog en tant qu’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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | setupapi.h |
| bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |