Fungsi SetPropW (winuser.h)

Menambahkan entri baru atau mengubah entri yang ada dalam daftar properti dari jendela yang ditentukan. Fungsi menambahkan entri baru ke daftar jika string karakter yang ditentukan belum ada dalam daftar. Entri baru berisi string dan handel. Jika tidak, fungsi mengganti handel string saat ini dengan handel yang ditentukan.

Sintaksis

BOOL SetPropW(
  [in]           HWND    hWnd,
  [in]           LPCWSTR lpString,
  [in, optional] HANDLE  hData
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela yang daftar propertinya menerima entri baru.

[in] lpString

Jenis: LPCTSTR

String null-terminated atau atom yang mengidentifikasi string. Jika parameter ini adalah atom, parameter harus berupa atom global yang dibuat oleh panggilan sebelumnya ke fungsi GlobalAddAtom. Atom harus ditempatkan dalam kata urutan rendah lpString; kata urutan tinggi harus nol.

[in, optional] hData

Jenis: HANDLE

Handel ke data yang akan disalin ke daftar properti. Handel data dapat mengidentifikasi nilai apa pun yang berguna untuk aplikasi.

Mengembalikan nilai

Jenis: BOOL

Jika handel data dan string ditambahkan ke daftar properti, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Sebelum jendela dihancurkan (yaitu, sebelum kembali dari memproses pesan WM_NCDESTROY), aplikasi harus menghapus semua entri yang telah ditambahkan ke daftar properti. Aplikasi harus menggunakan fungsi RemoveProp untuk menghapus entri.

SetProp tunduk pada pembatasan Isolasi Hak Istimewa Antarmuka Pengguna (UIPI). Proses hanya dapat memanggil fungsi ini pada jendela milik proses tingkat integritas yang lebih rendah atau sama. Ketika UIPI memblokir perubahan properti, GetLastError akan mengembalikan 5.

Contoh

Misalnya, lihat Menambahkan Properti Jendela.

Persyaratan

Lihat juga

Konseptual

GlobalAddAtom

Referensi

RemoveProp

WM_NCDESTROY

Properti Jendela

ITaskbarList2::MarkFullscreenWindow