SetupAddToDiskSpaceListA, fonction (setupapi.h)

Article
11/20/2024

[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 SetupAddToDiskSpaceList ajoute une opération de suppression ou de copie unique à une liste d’espace disque. Pour ajouter toutes les opérations de fichier dans une section d’un fichier INF, utilisez SetupAddSectionToDiskSpaceList, ou SetupAddInstallSectionToDiskSpaceList.

La compression de disque cible est ignorée par cette fonction. Les fichiers sont supposés occuper leur taille complète sur le disque cible.

Syntaxe

WINSETUPAPI BOOL SetupAddToDiskSpaceListA(
  [in] HDSKSPC  DiskSpace,
  [in] PCSTR    TargetFilespec,
  [in] LONGLONG FileSize,
  [in] UINT     Operation,
  [in] PVOID    Reserved1,
  [in] UINT     Reserved2
);

Paramètres

[in] DiskSpace

Gérez la liste d’espace disque.

[in] TargetFilespec

Nom du fichier à ajouter à la liste d’espace disque. Vous devez utiliser une chaîne terminée par null qui spécifie un chemin complet. Sinon, le chemin d’accès doit être relatif au répertoire actif.

[in] FileSize

Taille non compressée du fichier tel qu’il existe dans le répertoire cible, en octets. Vous pouvez utiliser SetupGetSourceFileSize pour récupérer ces informations à partir d’un fichier INF. Ce paramètre est ignoré pour les opérations FILEOP_DELETE.

[in] Operation

Opération de fichier à ajouter à la liste. Ce paramètre peut être l’une des valeurs suivantes.

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

[in] Reserved1

Doit être égal à zéro.

[in] Reserved2

Doit être égal à zéro.

Valeur de retour

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’erreur étendues, appelez GetLastError.

Remarques

Note

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

Voir aussi

Functions

Vue d’ensemble

Partager via