SHQueryRecycleBinA, fonction (shellapi.h)
Récupère la taille de la Corbeille et le nombre d’éléments qu’il contient, pour un lecteur spécifié.
Syntaxe
SHSTDAPI SHQueryRecycleBinA(
[in, optional] LPCSTR pszRootPath,
[in, out] LPSHQUERYRBINFO pSHQueryRBInfo
);
Paramètres
[in, optional] pszRootPath
Type : LPCTSTR
Adresse d’une chaîne terminée par null de longueur maximale MAX_PATH pour contenir le chemin du lecteur racine sur lequel se trouve la Corbeille. Ce paramètre peut contenir l’adresse d’une chaîne mise en forme avec le lecteur, le dossier et les noms des sous-dossiers (C:\Windows\System...).
[in, out] pSHQueryRBInfo
Type : LPSHQUERYRBINFO
Adresse d’une structure SHQUERYRBINFO qui reçoit les informations de la Corbeille. Le membre cbSize de la structure doit être défini sur la taille de la structure avant d’appeler cette API.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .
Remarques
Avec Windows 2000, si NULL est passé dans le paramètre pszRootPath , la fonction échoue et retourne un code d’erreur E_INVALIDARG. Dans les versions antérieures du système d’exploitation, vous pouvez passer une chaîne vide ou NULL. Si pszRootPath contient une chaîne vide ou NULL, les informations sont récupérées pour toutes les Corbeilles sur tous les lecteurs.
Notes
L’en-tête shellapi.h définit SHQueryRecycleBin 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
| Client minimal pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shellapi.h |
| Bibliothèque | Shell32.lib |
| DLL | Shell32.dll (version 4.71 ou ultérieure) |