SetupRemoveFromDiskSpaceListA, 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 SetupRemoveFromDiskSpaceList supprime une opération de suppression ou de copie de fichiers d’une liste d’espace disque.

Syntaxe

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

Paramètres

[in] DiskSpace

Gérer vers une liste d’espace disque.

[in] TargetFilespec

Pointeur vers une chaîne terminée par null qui spécifie le nom de fichier à supprimer de la liste d’espace disque. Il s’agit généralement d’un chemin complet. Sinon, le chemin d’accès doit être relatif au répertoire actif.

[in] Operation

Opération de fichier à supprimer de 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 le fichier ne figurait pas dans la liste, la fonction SetupRemoveFromDiskSpaceList renvoie une valeur différente de zéro et GetLastError renvoie ERROR_INVALID_DRIVE ou ERROR_INVALID_NAME. Si le fichier se trouvait dans la liste, la routine retourne une valeur différente de zéro, et GetLastError retourne NO_ERROR.

Si la routine échoue pour une autre raison, elle retourne zéro et GetLastError renvoie des informations d’erreur étendues.

Remarques

Notes

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

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

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList

SetupRemoveSectionFromDiskSpaceList