Fungsi SHCreateItemInKnownFolder (shobjidl_core.h)

Artikel
13/03/2024

Membuat objek item Shell untuk satu file yang ada di dalam folder yang diketahui.

Sintaks

C++

SHSTDAPI SHCreateItemInKnownFolder(
  [in]           REFKNOWNFOLDERID kfid,
                 DWORD            dwKFFlags,
  [in, optional] PCWSTR           pszItem,
  [in]           REFIID           riid,
  [out]          void             **ppv
);

Parameter

[in] kfid

Jenis: REFKNOWNFOLDERID

Referensi ke KNOWNFOLDERID, GUID yang mengidentifikasi folder yang berisi item.

dwKFFlags

Jenis: DWORD

Bendera yang menentukan opsi khusus dalam pengambilan objek. Nilai ini bisa 0; jika tidak, satu atau beberapa nilai KNOWN_FOLDER_FLAG .

[in, optional] pszItem

Jenis: PCWSTR

Penunjuk ke buffer yang dihentikan null yang berisi nama file item baru sebagai string Unicode. Parameter ini juga bisa NULL. Dalam hal ini, IShellItem yang mewakili folder yang diketahui itu sendiri dibuat.

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka yang mewakili item, diambil melalui ppv. Nilai ini biasanya IID_IShellItem atau IID_IShellItem2.

[out] ppv

Jenis: void**

Ketika fungsi ini berhasil dikembalikan, berisi penunjuk antarmuka yang diminta dalam riid. Ini biasanya IShellItem atau IShellItem2.

Nilai kembali

Jenis: HRESULT

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

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
Set API	ext-ms-win-shell-shell32-l1-2-0 (diperkenalkan dalam Windows 8.1)

Lihat juga

Sampel Folder yang Diketahui

Bagikan melalui