IShellFolderView::Metode AddObject (shlobj_core.h)

[AddObject tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Menambahkan item ke tampilan.

Sintaks

HRESULT AddObject(
  [in]  PUITEMID_CHILD pidl,
  [out] UINT           *puItem
);

Parameter

[in] pidl

Jenis: PUITEMID_CHILD

Penunjuk ke ItemID yang menentukan item yang akan ditambahkan ke tampilan.

[out] puItem

Jenis: UINT*

Penunjuk ke nilai yang, ketika metode ini berhasil dikembalikan, menerima posisi indeks item yang ditambahkan.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Jika Anda segera memanggil IShellFolderView::GetObject dengan indeks ini, Anda akan mendapatkan salinan ITEMID_CHILD yang Anda tambahkan. Namun, posisi indeks item dapat berubah dari waktu ke waktu, sehingga kode tidak dapat mempercayai bahwa indeks tertentu selalu mengembalikan ITEMID_CHILD yang sama.

Item yang ditambahkan melalui metode ini dapat dihapus dari tampilan oleh sumber data kapan saja.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h