SetupRemoveFromDiskSpaceListW, fonction (setupapi.h)
[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 SetupRemoveFromDiskSpaceListW(
[in] HDSKSPC DiskSpace,
[in] PCWSTR 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 |
|---|---|
|
Opération de suppression de fichier. |
|
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 |