Fungsi GetPropW (winuser.h)

Artikel
11/20/2024

Mengambil handel data dari daftar properti jendela yang ditentukan. String karakter mengidentifikasi handel yang akan diambil. String dan handel harus telah ditambahkan ke daftar properti dengan panggilan sebelumnya ke fungsi SetProp .

Sintaksis

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

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela yang daftar propertinya akan dicari.

[in] lpString

Jenis: LPCTSTR

Atom yang mengidentifikasi string. Jika parameter ini adalah atom, parameter harus dibuat dengan menggunakan fungsi GlobalAddAtom. Atom, nilai 16-bit, harus ditempatkan dalam kata urutan rendah dari parameter lpString; kata urutan tinggi harus nol.

Mengembalikan nilai

Jenis: HANDLE

Jika daftar properti berisi string, nilai yang dikembalikan adalah handel data terkait. Jika tidak, nilai yang dikembalikan null.

Komentar

Nota

Header winuser.h mendefinisikan GetProp sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

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

Lihat juga

Konseptual

GlobalAddAtom

Referensi

SetProp

Properti Jendela

ITaskbarList2::MarkFullscreenWindow

Bagikan melalui