Navigálás a névtérben

Most már rendelkezik a névtér bármely pontjára való navigáláshoz szükséges alapvető elemekkel. A legegyszerűbb módja, hogy az alkalmazása hívja meg SHGetDesktopFolder az asztal IShellFolder felületének lekéréséhez. Ezután a névtéren lefelé navigálva az alkalmazás a következő lépéseket hajthatja végre:

1. A mappa tartalmának számbavétele.
2. Határozza meg, hogy mely objektumok almappák, és válasszon egyet.
3. Csatlakozzon az almappához a IShellFolder felületének lekéréséhez.

Ismételje meg ezeket a lépéseket a cél eléréséhez szükséges gyakran.

Egy egyszerű példa a névtér navigációjára

A következő mintakód egy egyszerű konzolalkalmazás, amely az előző szakaszokban tárgyalt eljárások egy részét mutatja be. A hibaellenőrzést az egyértelműség érdekében kihagyták. Az alkalmazás a következő feladatokat hajtja végre:

1. Lekéri a Program Files mappa IShellFolder felületét (Az IShellFolder felület használata).
2. A mappa tartalmának számbavétele (Mappa tartalmának számbavétele).
3. Meghatározza az összes megjelenítendő nevet, és kinyomtatja őket (Megjelenítendő nevek és egyéb tulajdonságok meghatározása).
4. Almappát keres (Mutató lekérése az almappák IShellFolder-felületére).
5. Kapcsolódik az első megtalált almappához (Mutató lekérése az almappa IShellFolder felületéhez).
6. Kinyomtatja az almappában lévő objektumok megjelenítendő nevét.

#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;
}