SetUserObjectInformationA 関数 (winuser.h)
指定したウィンドウ ステーションまたはデスクトップ オブジェクトに関する情報を設定します。
構文
BOOL SetUserObjectInformationA(
[in] HANDLE hObj,
[in] int nIndex,
[in] PVOID pvInfo,
[in] DWORD nLength
);
パラメーター
[in] hObj
ウィンドウ ステーション、デスクトップ オブジェクト、または現在のプロセス擬似ハンドルへのハンドル。 このハンドルは、 CreateWindowStation、 OpenWindowStation、 CreateDesktop、 OpenDesktop 、 GetCurrentProcess 関数によって返されます。
[in] nIndex
設定するオブジェクト情報。 このパラメーターには、次の値を指定できます。
| 値 | 説明 |
|---|---|
|
オブジェクトのハンドル フラグを設定します。 pvInfo パラメーターは、USEROBJECTFLAGS 構造体を指している必要があります。 |
|
TimerProc を呼び出すときの例外処理の動作を設定します。
hObj は 、GetCurrentProcess 関数によって返されるプロセス ハンドルである必要があります。
pvInfo パラメーターは BOOL を指している必要があります。 TRUE の場合、Windows は TimerProc への呼び出しを、すべての例外を使用して破棄する例外ハンドラーで囲みます。 これは Windows 2000 以降の既定の動作ですが、今後のバージョンの Windows では変更される可能性があります。 pvInfo が FALSE を指している場合、Windows は TimerProc への呼び出しを例外ハンドラーで囲む必要はありません。 FALSE の設定をお勧めします。 そうしないと、アプリケーションが予期しない動作をし、セキュリティの悪用に対してより脆弱になる可能性があります。 |
[in] pvInfo
オブジェクト情報を含むバッファーへのポインター、または BOOL。
[in] nLength
pvInfo が指すバッファーに含まれる情報のサイズ (バイト単位)。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合、戻り値は 0 になります。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
注意
winuser.h ヘッダーは、SETUserObjectInformation をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |