Navegando pelo namespace

Agora você tem todos os elementos essenciais necessários para navegar em qualquer lugar no namespace. A maneira mais simples de iniciar é fazer com que seu aplicativo chame SHGetDesktopFolder para recuperar a interface IShellFolder da área de trabalho. Em seguida, para navegar para baixo pelo namespace , seu aplicativo pode seguir estas etapas:

  1. Enumerar o conteúdo da pasta.
  2. Determine quais objetos são subpastas e selecione uma.
  3. Associe à subpasta para recuperar sua interface IShellFolder .

Repita essas etapas sempre que necessário para alcançar o destino.

Um exemplo simples de navegação de namespace

O código de exemplo a seguir é um aplicativo de console simples que ilustra vários dos procedimentos discutidos nas seções anteriores. A verificação de erros foi omitida para maior clareza. O aplicativo executa as seguintes tarefas:

  1. Recupera a interface IShellFolder da pasta Arquivos de Programas (usando a interface IShellFolder).
  2. Enumera o conteúdo da pasta (enumerando o conteúdo de uma pasta).
  3. Determina todos os nomes de exibição e os imprime (Determinando nomes de exibição e outras propriedades).
  4. Procura uma subpasta (obtendo um ponteiro para a interface IShellFolder de uma subpasta).
  5. Associa-se à primeira subpasta que encontra (Obtendo um ponteiro para a interface IShellFolder de uma subpasta).
  6. Imprime os nomes de exibição dos objetos na subpasta.
#include <shlobj.h>
#include <shlwapi.h>
#include <iostream.h>

main()
{
    LPITEMIDLIST pidlProgFiles = NULL;
    LPITEMIDLIST pidlItems = NULL;
    IShellFolder *psfFirstFolder = NULL;
    IShellFolder *psfDeskTop = NULL;
    IShellFolder *psfProgFiles = NULL;
    LPENUMIDLIST ppenum = NULL;
    ULONG celtFetched;
    HRESULT hr;
    STRRET strDispName;
    TCHAR pszDisplayName[MAX_PATH];
    ULONG uAttr;
   
    CoInitialize( NULL );
    
    hr = SHGetFolderLocation(NULL, CSIDL_PROGRAM_FILES, NULL, 0, &pidlProgFiles);

    hr = SHGetDesktopFolder(&psfDeskTop);

    hr = psfDeskTop->BindToObject(pidlProgFiles, NULL, IID_IShellFolder, (LPVOID *) &psfProgFiles);
    psfDeskTop->Release();

    hr = psfProgFiles->EnumObjects(NULL,SHCONTF_FOLDERS | SHCONTF_NONFOLDERS, &ppenum);

    while( hr = ppenum->Next(1,&pidlItems, &celtFetched) == S_OK && (celtFetched) == 1)
    {
        psfProgFiles->GetDisplayNameOf(pidlItems, SHGDN_INFOLDER, &strDispName);
        StrRetToBuf(&strDispName, pidlItems, pszDisplayName, MAX_PATH);
        cout << pszDisplayName << '\n';
        if(!psfFirstFolder)
        {
            uAttr = SFGAO_FOLDER;
            psfProgFiles->GetAttributesOf(1, (LPCITEMIDLIST *) &pidlItems, &uAttr);
            if(uAttr & SFGAO_FOLDER)
            {
                hr = psfProgFiles->BindToObject(pidlItems, NULL, IID_IShellFolder, (LPVOID *) &psfFirstFolder);
            }
        }
        CoTaskMemFree(pidlItems);
    }

    cout << "\n\n";

    ppenum->Release();

    if(psfFirstFolder)
    {
        hr = psfFirstFolder->EnumObjects(NULL,SHCONTF_FOLDERS | SHCONTF_NONFOLDERS, &ppenum);

        while( hr = ppenum->Next(1,&pidlItems, &celtFetched) == S_OK && (celtFetched) == 1)
        {
            psfFirstFolder->GetDisplayNameOf(pidlItems, SHGDN_INFOLDER, &strDispName);
            StrRetToBuf(&strDispName, pidlItems, pszDisplayName, MAX_PATH);
            cout << pszDisplayName << '\n';
            CoTaskMemFree(pidlItems);
        }
    }

    ppenum->Release();
    CoTaskMemFree(pidlProgFiles);
    psfProgFiles->Release();
    psfFirstFolder->Release();

    CoUninitialize();
    return 0;
}