GetUserObjectInformationW

指定したウィンドウステーションまたはデスクトップオブジェクトに関する情報を取得する。(Unicode)

GetUserObjectInformationW hObj, nIndex, pvInfo, nLength, lpnLengthNeeded

hObj : [intptr] ウィンドウステーションまたはデスクトップオブジェクトへのハンドル。このハンドルは CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop 関数が返すものである。
nIndex : [int] 
pvInfo : [intptr] オブジェクト情報を受け取るバッファへのポインタ。
nLength : [int] pvInfo が指すバッファのバイト単位のサイズ。
lpnLengthNeeded : [var] 要求された情報の格納に必要なバイト数を受け取る変数へのポインタ。関数終了時にこの変数の値が nLength より大きい場合、関数は FALSE を返し、情報は pvInfo バッファに何もコピーされない。lpnLengthNeeded が指す変数の値が nLength 以下の場合、情報ブロック全体がコピーされる。

(プラグイン / モジュール : user32.dll)

解説

指定したウィンドウステーションまたはデスクトップオブジェクトに関する情報を取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は非ゼロである。関数が失敗した場合、戻り値はゼロである。拡張エラー情報を取得するには GetLastError
を呼ぶ。

[備考]
> [!NOTE] > winuser.h ヘッダは GetUserObjectInformation を、UNICODE
プリプロセッサ定数の定義に応じて ANSI 版と Unicode
版を自動選択するエイリアスとして定義する。エンコーディングに依存するコードと、エンコーディング中立なエイリアスの混在は、コンパイルエラーや実行時エラーの原因となる。詳しくは
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報