Metode IActiveDesktop::GetDesktopItem (shlobj_core.h)

Mendapatkan item desktop yang ditentukan.

Sintaks

HRESULT GetDesktopItem(
            int         nComponent,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Parameter

nComponent

Jenis: int

Nilai bilangan bulat panjang yang tidak ditandatangani yang berisi indeks item desktop. Nilai indeks dimulai dari nol. Gunakan IActiveDesktop::GetDesktopItemCount untuk mengambil hitungan jumlah total item desktop.

[in, out] pcomp

Jenis: LPCOMPONENT

Alamat struktur COMPONENT dari item desktop yang diambil.

dwReserved

Jenis: DWORD

Dicadangkan. Harus diatur ke nol.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Nilai indeks akan berubah saat item desktop ditambahkan dan dihapus dari Active Desktop. Aplikasi tidak dapat mengasumsikan bahwa nilai indeks akan selalu dikaitkan dengan item desktop tertentu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h
DLL	Shell32.dll (versi 4.71 atau yang lebih baru)

Lihat juga

IActiveDesktop