IKnownFolderManager::Metode GetFolder (shobjidl_core.h)

Mendapatkan objek yang mewakili folder yang diketahui yang diidentifikasi oleh KNOWNFOLDERID-nya. Objek memungkinkan Anda untuk mengkueri properti folder tertentu, mendapatkan jalur folder saat ini, mengalihkan folder ke lokasi lain, dan mendapatkan jalur folder sebagai ITEMIDLIST.

Sintaks

HRESULT GetFolder(
  [in]  REFKNOWNFOLDERID rfid,
  [out] IKnownFolder     **ppkf
);

Parameter

[in] rfid

Jenis: REFKNOWNFOLDERID

Referensi ke KNOWNFOLDERID.

[out] ppkf

Jenis: IKnownFolder**

Ketika metode ini kembali, berisi penunjuk antarmuka ke objek IKnownFolder yang mewakili folder .

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
E_INVALIDARG	Antara lain, nilai ini dapat menunjukkan bahwa parameter rfid mereferensikan KNOWNFOLDERID yang tidak ada pada sistem. Tidak semua nilai KNOWNFOLDERID ada di semua sistem. Gunakan IKnownFolderManager::GetFolderIds untuk mengambil kumpulan nilai KNOWNFOLDERID untuk sistem saat ini.

Keterangan

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

Kapan Harus Digunakan

Gunakan metode ini ketika Anda mengetahui dengan tepat folder mana yang diketahui yang Anda cari dan ingin mengaksesnya secara langsung.

Persyaratan

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

Sampel Folder yang Diketahui