Fungsi RemovePropA (winuser.h)

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

Sintaksis

HANDLE RemovePropA(
  [in] HWND   hWnd,
  [in] LPCSTR 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 harus dibuat menggunakan fungsi GlobalAddAtom. Atom, nilai 16-bit, harus ditempatkan dalam kata urutan rendah lpString; kata urutan tinggi harus nol.

Mengembalikan nilai

Jenis: HANDLE

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

Komentar

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. Ketika UIPI memblokir perubahan properti, GetLastError akan mengembalikan 5.

Contoh

Misalnya, lihat Menghapus Properti Jendela.

Persyaratan

Lihat juga

AddAtom

Konseptual

GetProp

Referensi

SetProp

Properti Jendela