IShellFolderView::Metode UpdateObject (shlobj_core.h)

Artikel
03/02/2024

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

Mengganti item dalam tampilan dengan item lain.

Sintaks

HRESULT UpdateObject(
  [in]  PUITEMID_CHILD pidlOld,
  [in]  PUITEMID_CHILD pidlNew,
  [out] UINT           *puItem
);

Parameter

[in] pidlOld

Jenis: PUITEMID_CHILD

Item asli.

[in] pidlNew

Jenis: PUITEMID_CHILD

Item baru.

[out] puItem

Jenis: UINT*

Ketika metode ini kembali, berisi penunjuk ke indeks item yang diganti. Anda dapat menggunakan nilai ini untuk memanggil IShellFolderView::GetObject nanti untuk mendapatkan kembali PITEMID_CHILD yang baru saja Anda tambahkan.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Jika Anda segera memanggil IShellFolderView::GetObject dengan indeks yang dikembalikan oleh puItem, 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.

Perubahan yang dilakukan melalui metode ini dapat dibuang dalam tampilan oleh sumber data kapan saja.

Persyaratan

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

Bagikan melalui