Fonction SetupAddSectionToDiskSpaceListA (setupapi.h)

[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 SetupAddSectionToDiskSpaceList ajoute à une liste d’espace disque toutes les opérations de suppression ou de copie de fichiers répertoriées dans une section Copier des fichiers ou Supprimer des fichiers d’un fichier INF.

La compression du disque cible est ignorée par cette fonction. Les fichiers sont supposés occuper leur taille totale sur le disque cible.

Syntaxe

WINSETUPAPI BOOL SetupAddSectionToDiskSpaceListA(
  [in] HDSKSPC DiskSpace,
  [in] HINF    InfHandle,
  [in] HINF    ListInfHandle,
  [in] PCSTR   SectionName,
  [in] UINT    Operation,
  [in] PVOID   Reserved1,
  [in] UINT    Reserved2
);

Paramètres

[in] DiskSpace

Gérez vers la liste d’espace disque.

[in] InfHandle

Gérez dans un fichier INF ouvert qui contient la section SourceDisksFiles . Si ListInfHandle n’est pas spécifié, ce fichier INF doit également contenir la section nommée par SectionName.

[in] ListInfHandle

Handle facultatif pour un fichier INF ouvert qui contient la section spécifiée par SectionName. Sinon, InfHandle est supposé contenir cette section.

[in] SectionName

Nom de la section Copier des fichiers ou Supprimer des fichiers qui contient les opérations de fichier à ajouter à la liste d’espace disque. Utilisez une chaîne terminée par null.

[in] Operation

Type d’opération de fichier à ajouter à la liste. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
FILEOP_DELETE	Opération de suppression de fichier.
FILEOP_COPY	Opération de copie de fichiers.

[in] Reserved1

Doit être zéro.

[in] Reserved2

Doit être zéro.

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

Cette fonction nécessite un fichier INF Windows. Certains formats de fichiers INF plus anciens peuvent ne pas être pris en charge.

Notes

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

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

SetupAddInstallSectionToDiskSpaceList

SetupAddToDiskSpaceList

SetupRemoveSectionFromDiskSpaceList