Fonction SHQueryRecycleBinA (shellapi.h)

  • Article

Récupère la taille de la Corbeille et le nombre d’éléments qu’elle contient, pour un lecteur spécifié.

Syntaxe

SHSTDAPI SHQueryRecycleBinA(
  [in, optional] LPCSTR          pszRootPath,
  [in, out]      LPSHQUERYRBINFO pSHQueryRBInfo
);

Paramètres

[in, optional] pszRootPath

Type : LPCTSTR

L’adresse d’une chaîne terminée par un null 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 les noms de lecteur, de dossier et de sous-dossier (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, des 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. 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.

Configuration requise

Condition requise Valeur
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)

Voir aussi

SHEmptyRecycleBin