SetupRemoveFromDiskSpaceListA, fonction (setupapi.h)
[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 SetupRemoveFromDiskSpaceList supprime une opération de suppression ou de copie de fichier 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 du 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 être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Opération de suppression de fichier. |
|
Opération de copie de fichiers. |
[in] Reserved1
Doit être égal à zéro.
[in] Reserved2
Doit être égal à zéro.
Valeur de retour
Si le fichier n’était pas dans la liste, la fonction SetupRemoveFromDiskSpaceList retourne une valeur différente de zéro et GetLastError retourne ERROR_INVALID_DRIVE ou ERROR_INVALID_NAME. Si le fichier était dans la liste, une fois la routine réussie, 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 retourne des informations d’erreur étendues.
Remarques
Note
L’en-tête setupapi.h définit SetupRemoveFromDiskSpaceList 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 |