IShellLibrary::RemoveFolder-Methode (shobjidl_core.h)

Artikel
08/26/2023

Entfernt einen Ordner aus der Bibliothek.

Syntax

HRESULT RemoveFolder(
  [in] IShellItem *psiLocation
);

Parameter

[in] psiLocation

Typ: IShellItem*

Ein IShellItem-Objekt , das den zu entfernenden Ordner darstellt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Einfachheit halber kann SHRemoveFolderPathFromLibrary anstelle dieser Methode verwendet werden.

Beispiele

Das folgende Codebeispiel zeigt die Hilfsfunktion SHRemoveFolderPathFromLibrary, die diese Methode umschließt.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)