Metode IKnownFolder::GetFolderDefinition (shobjidl_core.h)

Artikel
08/26/2023

Mengambil struktur yang berisi elemen penentuan folder yang diketahui, yang mencakup kategori folder, nama, jalur, deskripsi, tipsalat, ikon, dan properti lainnya.

Sintaks

HRESULT GetFolderDefinition(
  [out] KNOWNFOLDER_DEFINITION *pKFD
);

Parameter

[out] pKFD

Jenis: KNOWNFOLDER_DEFINITION*

Ketika metode ini kembali, berisi penunjuk ke struktur KNOWNFOLDER_DEFINITION . Ketika tidak lagi diperlukan, aplikasi panggilan bertanggung jawab untuk memanggil FreeKnownFolderDefinitionFields untuk membebaskan sumber daya ini.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Ketika aplikasi pihak ketiga membuat folder mereka sendiri yang diketahui, mereka melakukannya dengan menentukannya dengan struktur KNOWNFOLDER_DEFINITION , lalu mendaftarkannya dengan sistem. Setiap informasi definisi folder yang diketahui terdaftar—yang disediakan sistem atau dibuat aplikasi—dapat diambil melalui metode ini.

Untuk memanggil metode ini, pemanggil harus memiliki setidaknya hak istimewa Pengguna.

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)

Lihat juga

IKnownFolder

Sampel Folder yang Diketahui

Bagikan melalui