setUserObjectInformationW 函式 (winuser.h)

發行項
03/04/2024

設定指定之視窗月臺或桌面對象的相關信息。

語法

BOOL SetUserObjectInformationW(
  [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 的設定。否則，應用程式可能會有無法預期的行為，而且可能會更容易遭受安全性攻擊。

值

意義

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 所指向之緩衝區中的資訊大小，以位元組為單位。

傳回值

如果函式成功，則傳回非零的值。

如果函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

注意

winuser.h 標頭會將 SetUserObjectInformation 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll