Fungsi SetUserObjectInformationW (winuser.h)

Mengatur informasi tentang stasiun jendela atau objek desktop yang ditentukan.

Sintaksis

BOOL SetUserObjectInformationW(
  [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 olehCreateWindowStation , OpenWindowStation, createDesktop, OpenDesktop atau fungsi GetCurrentProcess.

[in] nIndex

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

Nilai	Arti
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 menjadi 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 bertingkah tidak 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 pengembalian adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Nota

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

Lihat juga

CreateDesktop

CreateWindowStation

GetUserObjectInformation

OpenDesktop

OpenWindowStation

USEROBJECTFLAGS

Window Station dan Desktop Functions

Window Stations