Metode IShellLibrary::RemoveFolder (shobjidl_core.h)

Artikel
08/26/2023

Menghapus folder dari pustaka.

Sintaks

HRESULT RemoveFolder(
  [in] IShellItem *psiLocation
);

Parameter

[in] psiLocation

Jenis: IShellItem*

Objek IShellItem yang mewakili folder untuk dihapus.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Untuk kenyamanan, SHRemoveFolderPathFromLibrary dapat digunakan sebagai pengganti metode ini.

Contoh

Contoh kode berikut menunjukkan fungsi pembantu SHRemoveFolderPathFromLibrary, yang membungkus metode ini.

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

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)