SetupQueryDrivesInDiskSpaceListA, 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 SetupQueryDrivesInDiskSpaceList remplit une mémoire tampon avec une liste des lecteurs référencés par les opérations de fichier répertoriées dans la liste d’espace disque.
Syntaxe
WINSETUPAPI BOOL SetupQueryDrivesInDiskSpaceListA(
[in] HDSKSPC DiskSpace,
[in, out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Paramètres
[in] DiskSpace
Gérez vers la liste d’espace disque.
[in, out] ReturnBuffer
Pointeur facultatif vers une mémoire tampon qui reçoit les spécifications de lecteur, telles que « X : » ou « \server\share ». Vous devez utiliser une chaîne terminée par null. La chaîne terminée par un caractère Null ne doit pas dépasser la taille de la mémoire tampon de destination. Ce paramètre peut être NULL. Si ce paramètre n’est pas spécifié et qu’aucune erreur ne se produit, la fonction retourne une valeur différente de zéro et RequiredSize reçoit la taille de mémoire tampon requise pour contenir les spécifications du lecteur.
[in] ReturnBufferSize
Taille de la mémoire tampon pointée par ReturnBuffer, en caractères. Cela inclut la marque de fin null . Ce paramètre est ignoré si ReturnBuffer n’est pas spécifié.
[in, out] RequiredSize
Pointeur facultatif vers une variable qui reçoit la taille de la mémoire tampon requise pour contenir la liste de lecteurs terminés par null, en caractères. Cela inclut la marque de fin null .
Valeur retournée
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étaillées sur l’erreur, appelez GetLastError.
Si la fonction GetLastError retourne ERROR_INSUFFICIENT_BUFFER, ReturnBuffer a été spécifié, mais ReturnBufferSize a indiqué que la mémoire tampon fournie était trop petite.
Remarques
Notes
L’en-tête setupapi.h définit SetupQueryDrivesInDiskSpaceList 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 |