Metode IKnownFolder::GetFolderDefinition (shobjidl_core.h)
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) |