Metode IKnownFolderManager::RegisterFolder (shobjidl_core.h)

Artikel
08/26/2023

Menambahkan folder baru yang diketahui ke registri. Digunakan terutama oleh vendor perangkat lunak independen (ISV) yang menambahkan salah satu folder mereka sendiri ke sistem folder yang diketahui.

Sintaks

HRESULT RegisterFolder(
  [in] REFKNOWNFOLDERID             rfid,
  [in] const KNOWNFOLDER_DEFINITION *pKFD
);

Parameter

[in] rfid

Jenis: REFKNOWNFOLDERID

GUID yang mewakili folder yang diketahui.

[in] pKFD

Jenis: const KNOWNFOLDER_DEFINITION*

Penunjuk ke struktur KNOWNFOLDER_DEFINITION yang valid yang menyediakan detail folder baru.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Catatan Metode ini memperbarui HKEY_LOCAL_MACHINE dan oleh karena itu perlu dijalankan dalam konteks administrator. Program penyetelan memerlukan hak administrator untuk mendaftarkan atau membatalkan pendaftaran folder yang diketahui.

IKnownFolderManager::RegisterFolder mencoba memverifikasi bahwa KNOWNFOLDERID baru tidak merujuk ke jalur sistem file yang sudah diarahkan oleh KNOWNFOLDERID yang ada. Jika KNOWNFOLDERID baru ditemukan untuk melakukannya, metode ini gagal.

Beberapa nilai KNOWNFOLDERID untuk jalur sistem file yang sama dapat menyebabkan beberapa masalah, seperti konflik dalam file Desktop.ini yang menyebabkan kebingungan tentang bahasa atau properti apa yang akan ditampilkan untuk folder. Beberapa nilai KNOWNFOLDERID juga dapat menyebabkan kebingungan pada jalur bilah alamat atau tugas apa yang ditampilkan untuk folder di Windows Explorer.

Anda dapat menekan tampilan halaman Kustomisasi dari jendela Properti folder yang diketahui. Untuk melakukannya, atur nilai REG_DWORD registri berikut:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  FolderDescriptions
                     Folder GUID
                        PropertyBag
                           NoCustomize = 0x00000001 (1)

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll

Lihat juga

IKnownFolderManager

IKnownFolderManager::UnregisterFolder

Sampel Folder yang Diketahui

Bagikan melalui