Fungsi RemovePropW (winuser.h)

Artikel
08/28/2023

Menghapus entri dari daftar properti jendela yang ditentukan. String karakter yang ditentukan mengidentifikasi entri yang akan dihapus.

Sintaks

HANDLE RemovePropW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpString
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela yang daftar propertinya akan diubah.

[in] lpString

Jenis: LPCTSTR

String karakter yang dihentikan null atau atom yang mengidentifikasi string. Jika parameter ini adalah atom, parameter tersebut harus dibuat menggunakan fungsi GlobalAddAtom . Atom, nilai 16-bit, harus ditempatkan dalam kata lpString urutan rendah; kata urutan tinggi harus nol.

Nilai kembali

Jenis: HANDEL

Nilai yang dikembalikan mengidentifikasi data yang ditentukan. Jika data tidak dapat ditemukan dalam daftar properti yang ditentukan, nilai yang dikembalikan adalah NULL.

Keterangan

Nilai yang dikembalikan adalah nilai hData yang diteruskan ke SetProp; ini adalah nilai yang ditentukan aplikasi. Perhatikan, fungsi ini hanya menghancurkan hubungan antara data dan jendela. Jika sesuai, aplikasi harus membebaskan handel data yang terkait dengan entri yang dihapus dari daftar properti. Aplikasi hanya dapat menghapus properti yang telah ditambahkannya. Ini tidak boleh menghapus properti yang ditambahkan oleh aplikasi lain atau oleh sistem itu sendiri.

Fungsi RemoveProp mengembalikan handel data yang terkait dengan string sehingga aplikasi dapat membebaskan data yang terkait dengan handel.

Dimulai dengan Windows Vista, RemoveProp 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 dengan. Ketika UIPI memblokir perubahan properti, GetLastError akan mengembalikan 5.

Contoh

Misalnya, lihat Menghapus Properti Jendela.

Catatan

Header winuser.h mendefinisikan RemoveProp sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-window-l1-1-0 (diperkenalkan dalam Windows 8)