SetupCreateDiskSpaceListA, fonction (setupapi.h)

  • Article

[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 SetupCreateDiskSpaceList crée une liste d’espace disque.

Syntaxe

WINSETUPAPI HDSKSPC SetupCreateDiskSpaceListA(
  [in] PVOID Reserved1,
  [in] DWORD Reserved2,
  [in] UINT  Flags
);

Paramètres

[in] Reserved1

Non utilisé, doit être égal à zéro.

[in] Reserved2

Non utilisé, doit être égal à zéro.

[in] Flags

Ce paramètre peut être la valeur suivante.

SPDSL_IGNORE_DISK

Les opérations de fichier ajoutées à la liste ignorent les fichiers qui existent déjà sur le disque. Par exemple, si le disque contient un fichier de 5 000 octets, C :\MyDir\MyFile, et que vous ajoutez une opération de copie à la liste d’espace disque pour une nouvelle version, C :\MyDir\MyFile, soit 6500 octets, l’espace requis sera de 6500 octets (au lieu de 1500 octets, qui est la valeur retournée si vous ne définissez pas SPDSL_IGNORE_DISK).

Valeur retournée

Si la fonction réussit, elle retourne un handle à la liste d’espace disque.

Si la fonction échoue, elle retourne null. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notes

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

Voir aussi

Fonctions

Vue d'ensemble

SetupDestroyDiskSpaceList