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

設定するオブジェクト情報。 このパラメーターには、次の値を指定できます。

価値	意味
UOI_FLAGS 1	オブジェクトのハンドル フラグを設定します。 pvInfo パラメーターは、USEROBJECTFLAGS 構造体を指している必要があります。
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	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 ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetUserObjectInformation を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winuser.h (Windows.h を含む)
ライブラリ	User32.lib
DLL	User32.dll

関連項目

CreateDesktop の

CreateWindowStation の

GetUserObjectInformation の

OpenDesktop

OpenWindowStation

USEROBJECTFLAGS の

ウィンドウ ステーションとデスクトップ関数の

ウィンドウ ステーション