Fungsi GetUserObjectInformationW (winuser.h)

Mengambil informasi tentang stasiun jendela atau objek desktop yang ditentukan.

Sintaksis

BOOL GetUserObjectInformationW(
  [in]            HANDLE  hObj,
  [in]            int     nIndex,
  [out, optional] PVOID   pvInfo,
  [in]            DWORD   nLength,
  [out, optional] LPDWORD lpnLengthNeeded
);

Parameter

[in] hObj

Handel ke stasiun jendela atau objek desktop. Handel ini dikembalikan olehCreateWindowStation , OpenWindowStation, createDesktop, atau fungsi OpenDesktop.

[in] nIndex

Informasi yang akan diambil. Parameter bisa menjadi salah satu nilai berikut.

Nilai	Arti
UOI_FLAGS 1	Bendera handel. Parameter pvInfo harus menunjuk ke struktur USEROBJECTFLAGS .
UOI_HEAPSIZE 5	Ukuran timbunan desktop, dalam KB, sebagai nilai ULONG . Parameter hObj harus menjadi handel ke objek desktop, jika tidak, fungsi gagal. Windows Server 2003 dan Windows XP/2000: Nilai ini tidak didukung.
UOI_IO 6	TRUE jika parameter hObj adalah handel ke objek desktop yang menerima input dari pengguna. FALSE sebaliknya. Windows Server 2003 dan Windows XP/2000: Nilai ini tidak didukung.
UOI_NAME 2	Nama objek, sebagai string.
UOI_TYPE 3	Nama jenis objek, sebagai string.
UOI_USER_SID 4	Struktur SID yang mengidentifikasi pengguna yang saat ini terkait dengan objek yang ditentukan. Jika tidak ada pengguna yang terkait dengan objek, nilai yang dikembalikan dalam buffer yang ditujukkan oleh lpnLengthNeeded adalah nol. Perhatikan bahwa SID adalah struktur panjang variabel. Anda biasanya akan melakukan panggilan ke GetUserObjectInformation untuk menentukan panjang SID sebelum mengambil nilainya.

[out, optional] pvInfo

Penunjuk ke buffer untuk menerima informasi objek.

[in] nLength

Ukuran buffer yang ditujukkan oleh parameter pvInfo , dalam byte.

[out, optional] lpnLengthNeeded

Penunjuk ke variabel yang menerima jumlah byte yang diperlukan untuk menyimpan informasi yang diminta. Jika nilai variabel ini lebih besar dari nilai parameter nLength saat fungsi kembali, fungsi mengembalikan FALSE, dan tidak ada informasi yang disalin ke pvInfo buffer. Jika nilai variabel yang diacu oleh lpnLengthNeeded kurang dari atau sama dengan nilai nLength, seluruh blok informasi disalin.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Komentar

Nota

Header winuser.h mendefinisikan GetUserObjectInformation 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-windowstation-ansi-l1-1-0 (diperkenalkan di Windows 10, versi 10.0.10240)

Lihat juga

CreateDesktop

CreateWindowStation

GetUserObjectSecurity

OpenDesktop

OpenWindowStation

SID

setUserObjectInformation

SetUserObjectSecurity

USEROBJECTFLAGS

Window Station dan Desktop Functions