Fungsi SHCreateShellItem (shlobj_core.h)

Artikel
03/02/2024

Membuat objek IShellItem .

Catatan Disarankan agar Anda menggunakan SHCreateItemWithParent atau SHCreateItemFromIDList alih-alih fungsi ini.

Sintaks

SHSTDAPI SHCreateShellItem(
  [in, optional] PCIDLIST_ABSOLUTE pidlParent,
  [in, optional] IShellFolder      *psfParent,
  [in]           PCUITEMID_CHILD   pidl,
  [out]          IShellItem        **ppsi
);

Parameter

[in, optional] pidlParent

Jenis: PCIDLIST_ABSOLUTE

PIDL ke induk. Nilai ini bisa NULL.

[in, optional] psfParent

Jenis: IShellFolder*

Penunjuk ke IShellFolder induk. Nilai ini bisa NULL.

[in] pidl

Jenis: PCUITEMID_CHILD

PIDL ke item yang diminta. Jika informasi induk tidak disertakan dalam pidlParent atau psfParent, ini harus merupakan PIDL absolut.

[out] ppsi

Jenis: IShellItem**

Ketika metode ini kembali, berisi penunjuk antarmuka ke IShellItem baru.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

SHCreateShellItem membuat objek yang mewakili item namespace Shell. Pemanggil harus memberikan informasi induk di pidlParent atau psfParent; atau, pemanggil dapat memberikan IDList absolut dalam parameter pidl .

Ada tiga pola panggilan yang valid untuk fungsi ini:

Folder induk diidentifikasi oleh PIDLParent IDList absolut. Parameter pidl menunjuk ke IDList anak yang mengidentifikasi item dalam folder yang diidentifikasi oleh pidlParent.
```
IShellItem *psi;
SHCreateShellItem(pidlParent, NULL, pidlChild, &psi);
```
Folder induk diidentifikasi oleh psfParent. Parameter pidl menunjuk ke IDList anak yang mengidentifikasi item dalam folder yang diidentifikasi oleh psfParent.
```
IShellItem *psi;
SHCreateShellItem(NULL, psfParent, pidlChild, &psi);
```
Item diidentifikasi oleh IDList absolut yang diteruskan ke parameter pidl .
```
IShellItem *psi;
SHCreateShellItem(NULL, NULL, pidlFull, &psi);
```

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll
Set API	ext-ms-win-shell-shell32-l1-2-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Bagikan melalui