Bagikan melalui


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)

Lihat juga

IKnownFolder

Sampel Folder yang Diketahui