Navigera i namnområdet

Nu har du alla viktiga element som behövs för att navigera var som helst i namnområdet. Det enklaste sättet att starta är att låta programanropet SHGetDesktopFolder för att hämta skrivbordets IShellFolder--gränssnitt. Om du sedan vill navigera nedåt i namnområdet kan ditt program följa dessa steg:

1. Räkna upp mappens innehåll.
2. Ta reda på vilka objekt som är undermappar och välj en.
3. Binda till undermappen för att hämta dess IShellFolder- gränssnitt.

Upprepa dessa steg så ofta som behövs för att nå målet.

Ett enkelt exempel på namnområdesnavigering

Följande exempelkod är ett enkelt konsolprogram som illustrerar ett antal procedurer som beskrivs i föregående avsnitt. Felkontroll har utelämnats för tydlighetens skull. Programmet utför följande uppgifter:

1. Hämtar Program Files-mappens IShellFolder--gränssnitt (Använda IShellFolder-gränssnittet).
2. Räknar upp innehållet i mappen (räkna upp innehållet i en mapp).
3. Avgör alla visningsnamn och skriver ut dem (Att fastställa visningsnamn och andra egenskaper).
4. Söker efter en undermapp (Hämta en pekare till en undermapps IShellFolder-gränssnitt).
5. Binder till den första undermappen som hittas (Hämta en pekare till en undermapps IShellFolder-gränssnitt).
6. Skriver ut visningsnamnen för objekten i undermappen.

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