IShellLibrary：：RemoveFolder 方法 (shobjidl_core.h)

發行項
08/26/2023

從文件庫移除資料夾。

語法

HRESULT RemoveFolder(
  [in] IShellItem *psiLocation
);

參數

[in] psiLocation

類型： IShellItem*

IShellItem物件，代表要移除的資料夾。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

為了方便起見， SHRemoveFolderPathFromLibrary 可用來取代此方法。

範例

下列程式碼範例顯示協助程式函式 SHRemoveFolderPathFromLibrary，它會包裝此方法。

//
// from shobjidl.h
//
__inline HRESULT SHRemoveFolderPathFromLibrary(
    __in IShellLibrary *plib,
    __in PCWSTR pszFolderPath)
{
    PIDLIST_ABSOLUTE pidlFolder = 
      SHSimpleIDListFromPath (pszFolderPath);
    HRESULT hr = pidlFolder ? S_OK : E_INVALIDARG;

    if (SUCCEEDED(hr))
    {
        IShellItem *psiFolder;
        hr = SHCreateItemFromIDList (
          pidlFolder, 
          IID_PPV_ARGS(&psiFolder));

        if (SUCCEEDED(hr))
        {
            hr = plib->RemoveFolder(psiFolder);
            psiFolder->Release();
        }
        CoTaskMemFree(pidlFolder);
    }
    return hr;
}

需求


最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)