Metode IShellLibrary::AddFolder (shobjidl_core.h)

Artikel
03/04/2024

Menambahkan folder ke pustaka.

Sintaks

HRESULT AddFolder(
  [in] IShellItem *psiLocation
);

Parameter

[in] psiLocation

Jenis: IShellItem*

Objek IShellItem yang mewakili folder yang akan ditambahkan ke pustaka.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Ketika folder ditambahkan ke pustaka, folder juga ditambahkan ke indeks Windows Search .

Untuk kenyamanan, SHAddFolderPathToLibrary dapat digunakan sebagai pengganti metode ini.

Contoh

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

//
// From Shobjidl.h
//
__inline HRESULT SHAddFolderPathToLibrary (
    __in IShellLibrary *plib,
    __in PCWSTR pszFolderPath
)
{
    IShellItem *psiFolder;
    
    HRESULT hr = SHCreateItemFromParsingName (
      pszFolderPath, 
      NULL,
      IID_PPV_ARGS(&psiFolder));
    
    if (SUCCEEDED(hr))
    {
        hr = plib->AddFolder (psiFolder);
        psiFolder->Release ();
    }
    return hr;
}

Persyaratan

Persyaratan	Nilai
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)