共用方式為

流覽命名空間

  • 發行項

您現在擁有在命名空間中任何位置巡覽所需的所有基本元素。 啟動最簡單的方式是讓應用程式呼叫 SHGetDesktopFolder 來擷取桌面的 IShellFolder 介面。 然後，若要向下流覽命名空間，您的應用程式可以遵循下列步驟：

  1. 列舉資料夾的內容。
  2. 判斷哪些物件是子資料夾，然後選取一個。
  3. 系結至子資料夾以擷取其 IShellFolder 介面。

視需要重複這些步驟以達到目標。

命名空間導覽的簡單範例

下列範例程式碼片段是簡單的主控台應用程式，說明上述各節所討論的一些程式。 已省略錯誤檢查，以便清楚起見。 此應用程式會執行下列工作：

  1. 使用 IShellFolder 介面) 擷取 Program Files 資料夾的IShellFolder介面 (。
  2. 列舉資料夾的內容 (列舉資料夾) 的內容 。
  3. 決定所有顯示名稱，並列印 (判斷顯示名稱和其他屬性) 。
  4. 尋找子資料夾 (取得子資料夾 IShellFolder 介面) 的指標。
  5. 系結至它找到的第一個子資料夾 (取得子資料夾的 IShellFolder 介面 指標) 。
  6. 列印子資料夾中物件的顯示名稱。
#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;
}