SetupRemoveFileLogEntryA, fonction (setupapi.h)

  • Article

[Cette fonction peut être utilisée 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 installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer les pilotes de périphérique.]

La fonction SetupRemoveFileLogEntry supprime une entrée ou une section d’un journal de fichiers.

Syntaxe

WINSETUPAPI BOOL SetupRemoveFileLogEntryA(
  [in] HSPFILELOG FileLogHandle,
  [in] PCSTR      LogSectionName,
  [in] PCSTR      TargetFilename
);

Paramètres

[in] FileLogHandle

Gérez le journal des fichiers comme retourné par SetupInitializeFileLog. L’appelant ne doit pas avoir passé SPFILELOG_QUERYONLY lorsque le fichier journal a été initialisé.

[in] LogSectionName

Pointeur vers une chaîne terminée par null qui spécifie le nom d’un regroupement logique de noms dans le fichier journal. Obligatoire pour les journaux non système. Sinon, LogSectionName peut être NULL.

[in] TargetFilename

Pointeur vers une chaîne terminée par null qui spécifie le nom du fichier tel qu’il existe sur la cible. Ce nom doit être dans n’importe quel format significatif pour l’appelant. Si la valeur est NULL, la section spécifiée par LogSectionName est supprimée. Impossible de supprimer la section main.

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notes

L’en-tête setupapi.h définit SetupRemoveFileLogEntry 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. La combinaison 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

   
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

Voir aussi

Fonctions

Présentation

SetupLogFile