Metode IKnownFolderManager::GetFolderByName (shobjidl_core.h)

Mendapatkan objek yang mewakili folder yang diketahui diidentifikasi dengan nama kanonisnya. 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 GetFolderByName(
  [in]  LPCWSTR      pszCanonicalName,
  [out] IKnownFolder **ppkf
);

Parameter

[in] pszCanonicalName

Jenis: LPCWSTR

Penunjuk ke nama kanonis yang tidak dilokalkan untuk folder yang diketahui, disimpan sebagai string Unicode yang dihentikan null. Jika folder ini adalah folder umum atau per pengguna , nilai ini juga digunakan sebagai nama nilai pengaturan registri "Folder Shell Pengguna". Nilai ini diambil melalui anggota pszName dari struktur KNOWNFOLDER_DEFINITION folder.

[out] ppkf

Jenis: IKnownFolder**

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

Nilai kembali

Jenis: HRESULT

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

Keterangan

Kapan Harus Digunakan

Gunakan metode ini ketika Anda mengetahui dengan tepat folder mana 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)

Lihat juga

IKnownFolderManager

Sampel Folder yang Diketahui