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’un chaîne null-terminated de longueur maximale MAX_PATH pour contenir le chemin d’accès 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 de sous-dossiers (C :\Windows\System...).
[in, out] pSHQueryRBInfo
Type : LPSHQUERYRBINFO
Adresse d’un SHQUERYRBINFO structure qui reçoit les informations de la Corbeille. Le cbSize membre de la structure doit être défini sur la taille de la structure avant d’appeler cette API.
Valeur de retour
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.
Remarques
Avec Windows 2000, si NULL est transmis 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.
Note
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. 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 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | shellapi.h |
| bibliothèque | Shell32.lib |
| DLL | Shell32.dll (version 4.71 ou ultérieure) |