Fungsi SetUserObjectInformationA (winuser.h)

Artikel
08/28/2023

Menyetel informasi tentang stasiun jendela atau objek desktop yang ditentukan.

Sintaks

BOOL SetUserObjectInformationA(
  [in] HANDLE hObj,
  [in] int    nIndex,
  [in] PVOID  pvInfo,
  [in] DWORD  nLength
);

Parameter

[in] hObj

Handel ke stasiun jendela, objek desktop, atau handel pseudo proses saat ini. Handel ini dapat dikembalikan oleh fungsi CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop , atau GetCurrentProcess .

[in] nIndex

Informasi objek yang akan diatur. Parameter ini bisa menjadi nilai berikut.

Nilai	Makna
UOI_FLAGS 1	Mengatur bendera handel objek. Parameter pvInfo harus menunjuk ke struktur USEROBJECTFLAGS .
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	Mengatur perilaku penanganan pengecualian saat memanggil TimerProc. hObj harus berupa handel proses yang dikembalikan oleh fungsi GetCurrentProcess . Parameter pvInfo harus menunjuk ke BOOL. Jika TRUE, Windows akan mengapit panggilannya ke TimerProc dengan handler pengecualian yang mengonsumsi dan membuang semua pengecualian. Ini telah menjadi perilaku default sejak Windows 2000, meskipun itu dapat berubah dalam versi Windows yang akan datang. Jika pvInfo menunjuk ke FALSE, Windows tidak akan mengapit panggilannya ke TimerProc dengan handler pengecualian. Pengaturan FALSE disarankan. Jika tidak, aplikasi bisa berprilaku tak terduga, dan bisa lebih rentan terhadap eksploitasi keamanan.

Nilai

Makna

UOI_FLAGS
1

Mengatur bendera handel objek. Parameter pvInfo harus menunjuk ke struktur USEROBJECTFLAGS .

UOI_TIMERPROC_EXCEPTION_SUPPRESSION
7

Mengatur perilaku penanganan pengecualian saat memanggil TimerProc. hObj harus berupa handel proses yang dikembalikan oleh fungsi GetCurrentProcess .

Parameter pvInfo harus menunjuk ke BOOL. Jika TRUE, Windows akan mengapit panggilannya ke TimerProc dengan handler pengecualian yang mengonsumsi dan membuang semua pengecualian. Ini telah menjadi perilaku default sejak Windows 2000, meskipun itu dapat berubah dalam versi Windows yang akan datang.

Jika pvInfo menunjuk ke FALSE, Windows tidak akan mengapit panggilannya ke TimerProc dengan handler pengecualian. Pengaturan FALSE disarankan. Jika tidak, aplikasi bisa berprilaku tak terduga, dan bisa lebih rentan terhadap eksploitasi keamanan.

[in] pvInfo

Penunjuk ke buffer yang berisi informasi objek, atau BOOL.

[in] nLength

Ukuran informasi yang terkandung dalam buffer yang diacu oleh pvInfo, dalam byte.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Catatan

Header winuser.h mendefinisikan SetUserObjectInformation 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


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 (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll