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 ヘッダーは、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

関連項目

CreateDesktop

CreateWindowStation

GetUserObjectInformation

OpenDesktop

OpenWindowStation

USEROBJECTFLAGS

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

ウィンドウステーション