GetUserObjectInformationA 関数 (winuser.h)
指定したウィンドウ ステーションまたはデスクトップ オブジェクトに関する情報を取得します。
構文
BOOL GetUserObjectInformationA(
[in] HANDLE hObj,
[in] int nIndex,
[out, optional] PVOID pvInfo,
[in] DWORD nLength,
[out, optional] LPDWORD lpnLengthNeeded
);
パラメーター
[in] hObj
ウィンドウ ステーションまたはデスクトップ オブジェクトへのハンドル。 このハンドルは、
[in] nIndex
取得する情報。 パラメーターには、次のいずれかの値を指定できます。
| 価値 | 意味 |
|---|---|
|
ハンドル フラグ。 pvInfo パラメーターは、USEROBJECTFLAGS 構造体を指している必要があります。 |
|
ULONG 値としてのデスクトップ ヒープのサイズ (KB 単位)。
hObj パラメーターはデスクトップ オブジェクトのハンドルである必要があります。それ以外の場合、関数は失敗します。
Windows Server 2003 および Windows XP/2000: この値はサポートされていません。 |
|
Windows Server 2003 および Windows XP/2000: この値はサポートされていません。 |
|
文字列としてのオブジェクトの名前。 |
|
文字列としてのオブジェクトの型名。 |
|
SID、指定したオブジェクトに現在関連付けられているユーザーを識別する構造体です。 ユーザーがオブジェクトに関連付けられていない場合、lpnLengthNeeded が指 |
[out, optional] pvInfo
オブジェクト情報を受け取るバッファーへのポインター。
[in] nLength
pvInfo パラメーターが指すバッファーのサイズ (バイト単位)。
[out, optional] lpnLengthNeeded
要求された情報を格納するために必要なバイト数を受け取る変数へのポインター。 この変数の値が、関数が戻るときに nLength パラメーターの値より大きい場合、関数は FALSE を返し、pvInfo バッファーには情報がコピーされていません。 lpnLengthNeeded
戻り値
関数が成功した場合、戻り値は 0 以外です。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetUserObjectInformation を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winuser.h (Windows.h を含む) |
| ライブラリ | User32.lib |
| DLL | User32.dll |
| API セットの | ext-ms-win-ntuser-windowstation-ansi-l1-1-0 (Windows 10 バージョン 10.0.10240 で導入) |
関連項目
CreateDesktop の
CreateWindowStation の
GetUserObjectSecurity の
SID の
SetUserObjectInformation の
SetUserObjectSecurity の
USEROBJECTFLAGS の