Função SHQueryRecycleBinW (shellapi.h)

Recupera o tamanho da Lixeira e o número de itens nela, para uma unidade especificada.

Sintaxe

SHSTDAPI SHQueryRecycleBinW(
  [in, optional] LPCWSTR         pszRootPath,
  [in, out]      LPSHQUERYRBINFO pSHQueryRBInfo
);

Parâmetros

[in, optional] pszRootPath

Tipo: LPCTSTR

O endereço de uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH para conter o caminho da unidade raiz na qual a Lixeira está localizada. Esse parâmetro pode conter o endereço de uma cadeia de caracteres formatada com os nomes de unidade, pasta e subpasta (C:\Windows\System...).

[in, out] pSHQueryRBInfo

Tipo: LPSHQUERYRBINFO

O endereço de uma estrutura SHQUERYRBINFO que recebe as informações da Lixeira. O membro cbSize da estrutura deve ser definido como o tamanho da estrutura antes de chamar essa API.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Com o Windows 2000, se NULL for passado no parâmetro pszRootPath , a função falhará e retornará um código de erro E_INVALIDARG. Em versões anteriores do sistema operacional, você pode passar uma cadeia de caracteres vazia ou NULL. Se pszRootPath contiver uma cadeia de caracteres vazia ou NULL, as informações serão recuperadas para todas as Lixeiras em todas as unidades.

Requisitos

Confira também

SHEmptyRecycleBin